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1eO INTRODUCTION 


The NOS/VE R1.~1.2 level 630 Software Release Bulletin (SRB) is to be 
used with the NOS/VE Installation and Upgrade Manual (Publication 
60463913) for installing NOS/VE and its software products. Control Data 
recommends that the $88 be read in its entirety prior to software 
instaildation. 


The SRB is the vehicle used to document any changes to the Installation 
and Upgrade Manual after it has gone to print. The SRB also documents a 
number of system deficiencies, I[t is necessary to install NOS 204.21 
Level 6390 or NOS/7SE 1.5 level 527» Level 528 of the Common Products» and 
CIP 003 before installing NOS/VE 81.1.2. 


The Following warnings and restrictions are especially important to this 
release 


1. A Backup Permanent _File ooeration must be done using the old 
system before upgrading to R1.1.2 and the files restored using 
jevyel R112. See Section 3-1-2 for more information. 


2 As of release 1.1.25 permanent File labels will be written in a 
new format which older systems will not be abte to read. This 
presents no problem untess permanent files created on a R1.1.2 
system or later must be used on a system older than R1.12- 
Should this situation arises sontact Central Software Support for 
guidance. 


36 A new version (V1.1) of object code tibrary format has been 
implemented to support improved message template capabilities. 
Message template modules are now created through the oOcy 
CREATE_MESSAGE MODULE subcommand which places message template 
modules on the object library. The OCU on the R1-1-22 system can 
accept object modutes fron hoth old (V1.6) and new (Vi.1) 
libraries but will only generate new (V1.1) format tlibraries. 
Libraries created by the R1.l.e2 OCU cannot be used by previous 
versions of the system or previous versions of OCU, Object 
modules (but not SCL procedures or program descriptions) can be 
moved from a Viel library to a V1.0 library as follows: 


ae Using the Viel CREOL» do the following: 


CREOL 
ADDM vllviiodrary "version V1.1 Jibrary” 
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Be 


GENL object_file f=f “generates an object file” 
b» Using the V1.0 CREOL» do the following; 


CREOL 
ADDM object file “generated as above" . 
GENL vlO_Ljiibrary “version V1.9 object ltibrary”™ 


Previous versions of messaga temolate modules cannot be used by 
the Riele2 system, They must be rebuilt using the 
GENERATE_MESSAGE_TEMPLATE proceduree A MODULE statement must be 
Placed at the beginning and a MODEND statement at the end of the 
message template definitions in order to provide the name for the 
message template module on the 9°U tibrary. The message temptate 
module should be placed on the same library as the. program 
description and CYBIL modules for the application program. 


A new version (V1.1) of source code tibrary format has been 
implemented to supoort current and Future performance 
improvements. It will be necessary to convert all older (pre 
R1.1.2) source libraries with a utility described in Section 5.25. 


Changes to the orogran interface require the recompilation of all 
CY3ItL modules. Modules which have not been recompiled may 
encounter 'declaration mismatch! errors when they are toaded. In 
additions any modules bound with runtime libraries wilt have to be 
rebound. 


Tape usage is restricted to permanent file backup/restores and 
dump analyzer operations. 


Rlels2 changes the operator interface to NOS/VE from the 
combination of the K-display and MDD interface to a singte CbdC 
CC634B terminal connected via cable AVLI7A to the mainframe's two 
port muitiplexor. The NOS/VE system console should be connected 
to port 0 of the two port multiolexor to attow RTA access via port 
ie 


The new NOS/VE system console orovides access to the operator 
facilitys system core debugger» the refreshing displays under 
VEDISPLAYs and an operator actions display. This console allows 
use of full ASCII for all key-ins. 


A single CC6348 can be used for both NOS and NOS/VE on the model 
810/830 systemse Howevers oniv one operating system can use the 
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system console at a given instant. The F6 key must be used to 
switch ownership of the system console between NOS and NOS/VE. 


For all other model 8xx mainframes supported by NOS/VE» the C170 
state operating system wil! continue to use the €C545 console and 
NOS/VE will use the €C6343 as its system console. 


In several sections of this documents PSR numbers are given following a 
probftem description. Additional information about the problem may be 
obtained From SOLVER by using this number. 
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2e0 FEATURES AND PRODUCTS 


The products associated with NOS/VE R1.1.2 tevel 530 are documented in 
detail in the Software Availability B8ulletin. Please refer to that 
document for this information, 
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3ei INSTALLATION 
3.1.1 NOS INSTALLATION 


1. 30th PASSON and IRHF must run out of the SYSTEMX account in order 
to access NOS output queue files which are transmitted to the 
NOS/VE input queue» If your site has changed the password of the 
SYSTEMX user» then you must alter the USER statements in the 
RUNJOBS procedure. Enter the following statements under the user 
nane from which NOS/VE is being deadstarted: 


COMMON» SYSTEM. 

STR»eSYSTEMsNVELIBsSU,ULIB/NVELTS. 

GETPROC»RUNJOBS. 

*Change ali USER statement oasswords to your site's value 
FSE»yRUNJDBS. 
ENVEFfFFF. jadds DSTLI8 to the library set 

REPPROCs»RUNJOGBS »L=DSTLIB. 

*Change DSTLIB from semi-orivate to private 
CHANGESDSTLIS/CT=P, 


2. In order to use the ST#NVE oaraneter to route a file to the input 
queues the user must have CUST validation flag set. 


3- The NOS system must have a LID table defined containing a PID of 
NVE with a LID of NVE. Naither entry has attributes. 


4%. A skeleton file (ACCOUNT) fis created during deadstart and used by 
Interim Remote Host and Interstate Communications to generate 
partner jobs that are submitted to NOS. This file is created 
within a procedure named ACCFILE which is located in user tlibrary 
NVELIB. Currentiys the ACCOUNT file created will contain the 
following: 


&JOB. 
USERsEUSERsEPASSWORD.! 
CHARGEsECHARGEsEPROJECT. 
JEOR 


When an Interstate Communications job (GETF» REPFs CREIC) is 
executed, the partner jod is created using the ACCOUNT file to set 
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up NOS accounting for the NO$ batch job. The field '&J0B' causes 
the job card that was created within Interstate Communications to 
pe put in its place. The fields tEUSER', FEPASSWORD!, *ECHARGE!, 
and ‘'&PROJECT!’ are Filled in with the accounting information 
antered by the user when executing a SET_LLINK ATTRIBUTES command. 
Interim Remote Host uses the ACCOUNT file in the same WAaYes 


If the charge and project numbers were not specified on the 
SETLLINK_ATTRIBUTCS command the characters '*.' are substituted 
for t&CHARGE? and blianks for ‘PROJECT. This implies that 
default charge will be used by NOS and the user must have the 
correct charge and project nunmders specified under MODVAL» 


Changes can be made to the ACCOUNT file so that a site may create 
their own accounting file For Remote Host and Interstate 
Communications jobs. 


Set the user library NVeELI® Fron the system in order to change the 
ACCFILE procedure. 


extract the procedure ACCFIL® Fron NYELIB. 
GETPROCsACCFILE»sNVELIB. 


Modify the procedure defined in this file by inserting the control 
cards necessary for accounting validation. 


Place the procedure onto OSTLI3. 


REPPROCsACCFILEs,OSTLIB. 


SoZ Rlsdel_=_Rhele2 INSTALLATION AND UPGRADE DIEEERENCES 


This section documents the differences between NOS/VE 1.1.1 and 
NOS/VE 121.2. It concentrates on the changes affecting those sites 
which tallored: 


1. system start up commands 
2. system shut down comnands 
3. command libraries 

4e system protogs and evilogs 


according to the NOS/VE 1.3.41 j%Instalilation and Upgrade Manual 
(604639138). Reloading of oermanent files at NOS/VE 1.1.2 is also 
discussed. 
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BeZel SYSTEM START UP COMMANDS 


Previously you modified record STAUC in the NOS file NVELIS. At 
1lele29 you should place your systen start up commands in the files 


$systam.startlup_commands 


This file is created only by an installation deadstarts, with files 
being reloaded from the REQUIRED tape (ieeer» the first time you 
install NOS /VE 1.1.2). 


Examine the contents of tsysten.start_up_commands,s and if you want 
to change the commandss sinply overwrite this file with the 
commands you want executed. Possioie commands include? ; 


1. set_default family 
2» set _job_cliass_limits 
3. set_command_list (for the operator command list) 


You may also wish to execute certain commands based on the type of 
deadstart being performed. You can determine the type of deadstart 
by testing the value of the variable rayv$load_options which may 
have these values. 


TINSTALL? Installation deadstart was performeds the 
value of set_file_loaindg options was set 
to install (the default value § for an 


installation deadstart). 


"RELOAD! Installation deadstart» the value of 
set _ file_loading_options was set to reload. 


*NORMAL! Continuation deadstart» the value of 
set _ file _floading_options was set to normal 
{the default value for a continuation 
deadstart). 


UPGRADE * Continuation deadstarts the value of 
set_file_ loading _options was set to 
upgrade. 


INSTALL DEFERRED_LFILES *Continuation deadstarty»s the value of 
set _ file loaindg_ootions was set to 
install deferred files. 
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Bede2 SYSTEM SHUT DOWN COMMANDS 


At NOS/VE Llelel»s this file was record SHUDC on the NOS file NVELIB. 
The file 

$systems,shut_ down commands 
is created the first time you instal! NOS/VE 1.1.2. Cverwrite this 
File with any commands you wish to be executed during system shut 
down. 


Be2@e3 SITE COMMAND LIBRARY 


At NOS/Ve Lelels the file 

Ssystemeosftsite command library 
was created from record i ISFSCL on the NOS file NVELI8. Any 
procedures you wished users to have as part of their command tists 
could be placed in this files as it was added by the system orolog 
to users’ command Jists. 


This file is now reserved for €9Cs and the system is released such 
that this fle is no longer automaticaily added to users! command 
j ists. 


Procedures you want to make accessible to your users should be 
placed on another command libdrarys and the system prolog should be 
modified appropriately (see below). 


Seo2e0% GPERATOR COMMAND LIBRARY 


At NOS/VE Lelels the file 

$systemeosftoperator_command_library 
was created from record OSFOCL on the ANOS file NVELIB. Any 
procedures you wished your opnerators to have as part of their 
command tists could be placed in this files as it was part of the. 
operator's command tist. 


This file is now reserved for COC» but it is stitl in the 
operator's command list. 


Procedures you want to make accessible to your operators should be 
Piaced on another command library» and the system start up commands 
(see above) should be modified appropriately to also add your 
operator command library to the operator's command list. 


Should you have to reload permanent files» your operator command 
library will not be available until. files are reloaded. This 
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Should not be a problems untess you want to use a restore procedure 
different from the one supplied by CDC. In this cases place your. 
procedure on the NOS file SITECP (just like the ¢€DdC restore 
procedure) and rebuild your deadstart file with REPRECS. This 
procedure will then be made a permanent file under SSYSTEM for any 
installation deadstarts. 


3o2e5 SYSTEM PROLOGS AND EPILOGS 
At NOS/VE 1l.l.l»s the systen prolog executed commands which added: 


1. $systemescuemaintenance,command_ library 
20 ésysteme-osftsite comnand_libdrary 


The released system proliog nao tonger contains these commands. 
Alsos the first library has been renamed to; 
$systemescurecommand_library 


If you want to add these (or ofher) tlibraries to iusers' command 

lists» create a new cycie of the File 
$systemeprologs_and_eolilogssesysten_prolog 

and include commands to add these libraries to the user's command 

list. 


Se2Ze6 RELOADING FILES 


Perform the following steps if you have to reload your permanent 
File base-e 


le Execute an installation deadstarts, but using a NVE procedure 
file which pauses for onoerator system core commands. Enter 
the system core commands?! 


initdd 222222 
60 


Note that the GO must be uopercases and you do not enter the 
auto system core command. 


2e Deadstart will eventually pause with the set file toading 
options disptays Enter: 


set_file_foading option load_option=reload 
60 
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36 


4. 


After deadstart completes» execute the permanent file reload 
procedure, 


attach file Ssysten.restore 
restore 


Note that if you write your own permanent file reload 
procedure {see the IJpearator Command Library section) you 
would attach your procedure instead. 

After files are reloadeds enter: 


create _ family nye tadministrator~user~name! 
include _file $systan.start up_commands 
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1. Table l-1 and 2-2 of the NOS/V= Instailation and 


should be expanded to 
release lel2- 


Upgrade Manual 
inctude the larger memories supported by 
The expanded table is shown below: 


CM CM WORDS 
SIZE (OCTAL) 


M WORDS 
(DECIMAL) 


cM WORDS 
(HEX) 


CM BYTES 
(DECIMAL) 


CM BYTES 
(HEX) 


MB 

MB 

MB 

MB 

MB 

M3 

M3 

MB 

MB 

1G MB 
11 MB 
12 MB 
13 MB 
14 MB 
15 MB 
16 MB 
17 MB 
18 MB 
19 MB 
20 MB 
21 MB 
22 MB 
23 MB 
24 MB 
25 MB 
‘26 MB 
27 MB 
28 MB 
29 MB 
30 MB 
31 MB 
32 MB 


OO rue wr es 


4000000 
16000000 
14000000 
20000000 
24000000 
30000600 
34000000 
40000000 
44000000 
50000000 
54000000 
60000000 
64006000 
70669000 
74000000 
100000000 
104000006 
L1000c000 
114000000 
120000006 
124006000 
130000006 
134000006 
140000000 
144006000 
150000000 
154000006 
160000000 
164000000 
170000000 
174000000 
200000000 


131072 
262144 

393215 

524288 

65536) 

786432 

917504 

1048576 
1179648 
1310720 
1441792 
1572864 
1703936 
1835098 
1966080 
2097152 
2228224 
2359296 
2490368 
2621440 
2752512 
2883534 
3014656 
3145728 
3276890 
3407872 
3538944 
3670016 
3801088 
3932150 
4063232 
4194394 


20000 

40000 

60000 

30009 

9499990 
009090 
9E 9000 
1500090 
129609 
149000 
160000 
1890900 
VA9000 
1096000 
LE9006 
2906900 
229009 
2490900 
2600090 
289000 
249006 
200000 
2E9000 
399000 
320090 
340009 
360000 
3890000 
340090 
300000 
3E0000 
49000900 


1048576 

2097152 

3145728 

4194304 

5242880 

6291456 

7340032 

8383608 

9437184 

10485760 
11534336 
12582912 
13631488 
14686064 
15728640 
16777216 
17825792 
18874368 
19922944 
20971520 
22020096 
23068672 
24117248 
25165824 
26214400 
27262976 
28311552 
29360128 
30408704 
31457280 
32505856 
33554432 


@e When upgrading from an earlier NOS/VE release to 


lele2 


you must 


backup 
deadstart NOS/VE Release 1.21.79 


your 


existing 


NOS/VE 


NOS/VE 


100000 

200000 

300000 

400000 

2909000 

609000 

7000590 

800000 

990000 

OA0DCOO 
OBO0005 
0000000 
0D00000 
QF00000 
OFOQ000 
1000000 
1106000 
1200000 
1300090 
1400000 
1500000 
1600600 
1700000 
18060006 
1909000 
LA00000 
1800000 
1000000 
1D00000 
1£00000 
LFOGO000 
2000000 


Release 
permanent files, 
and restore your NOS/VE permanent 
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files. System and product files contained on your permanent file 
backup tapes may have higher cycle numbers than those installed at 
NOS/VE Release lele2e Restoring files into the $SYSTEM catalog 
from your existing pernanent file backup tapes can resuit in a 
mixture of old and new installed versionss since the highest cycle 
is used by default as the installed version. If your permanent 
file backup tapes do. nat contain SYSTEM catalog files,» then 
foliow the instructioirs autiined in chapter two of the 
Installation and Upgrade manual! foublication number 60463913). 
The following steps describe how to upgrade to NOS/VE Release 
1.1.2 from an earlier NOS/VE releases, and how to reconcile 
differences between old and new SSYSTEM files; 


ae Once you have generated the NOS/VE Release 1.1.2 Deadstart 
Input file as described in chapter two of the Installation 
and Upgrade manual» enter the following command from the 
operator console to terminate your current NOS/VE system: 
TERMINATE_SYSTEM 


be Deadstart NOS 204.1 Jevel 6369 or NOS/BE 1.5 tevel 627 and 
NOS/VE Release 1.1.2. 32 sure to use a deadstart procedure 
file for NOS/VE that enables operator intervention prior to 
system core command orocessings Refer to the SETVE 
procedure documentation in the Installation and Upgrade 
manual when creating this deadstart procedure file. 


Ce When "ENTER SYSTEM CORE COMMANDS" appears on the operator 
consoles enter: 
INITDD <vsn> “where <vsn> identifies the deadstart device" 
GO (GO must be upper case) 


de When the file loading option display appears on the operator 
consoles, enter: 
SETLFILE_LGADING_OPTION RELIJAD*™ 
GO 


@»e When the message "DEADSTART COMPLETE" appears on the 
operator consoles restor2 your permanent file base fron the 
previous jevel of NOS/VE. Details of permanent file 
restoration may be found in the NOS/VE Operations Manual 
(60463914). 


If the $SYSTEM Files backed up from your prior NOS/VE 
release were created or nodified by your sites they may be 
incompatible with NOS/VE Release 141.2. You should identify 
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3e Remote 


which of these $SYSTE™M files are to be retained from the 
Prior release» and be prepared to verify these files once 
NOS/Vc Release 1.21.2 has been installed. 


Enter the Create _Fanity command for all Families which you 
restoreds excluding the <3$SYSTEM family. Ignore the 
diagnostic issued by the Create_Family command which 
indicates that the family user administrator's master 
catalog already exists for the family you restored. 


Enter the Following conmand from the operator console! 
TERMINATE_LSYSTEM 


Deadstart NOS/VE Release 1.1.22 a second tine. Use the same 
deadstart procedure file that was used for the previous 
NOS/VE Release 1.1.2 deadstart. 


When “ENTER SYSTEM CORE COMMANDS" appears on the operator 
consoles, enter: 
60 


When the file loading ootion display appearss enter: 
SETLFILE_LOADING_OPTION UPGRADE 
G0 


Follow the directions outlined in Chapter 8 of the NOS/VE 
Installation and Upgrade Manual (66463913). 


To determine SSYSTEM catalog contents and the sizes of files 
installed in the SSYSTEM catalogs enter these commands from 
the operator console: 

DISPLAY_CATALOG SSYSTEM DD=C DFALL O2XX 

PRINTLFILE XxX 


Login to NOS/VE Release 1.1.2 from an interactive terminal 
and enter the commands: 

setcl a=($system.osf$site_command_ library, 
$system.escuecommand_library) 

Verify_Installed_ Software 

One or more messages will be disoiayed for each product you 
have installed. 


installation and maintenance of the operating system 


requires an analyst or operator be present at the operator's 
consolee 
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If your site has the CYBER 170 APL2 jinstalleds»s and desires to 
migrate APL applications to the CYBER 180, AFIFIX should be 
replaced under user number APLO. AFIFIX»s a 176 resident permanent 
files now has the added capability of being a pre-processor for 
the 180 APL workspace CONVERT_LAPL2. Instailation instructions are 
described in this section} rafer to the APL section in Product Set 
Notes and Cautions for usage information. 


The first step of installation is to create the following NOS/VE 
Job to move the NOS/VE file to NOS. It may be created as a NOS or 
NOS/VE text file. This text file is then accessed from the 
operator consoles using the attach file or get_file command. The 
include_file command is executed to submit this job as a system 
Family batch job. 


(Note: User APLO has an instaflation definable password; the 
defaults APLO» Is being used For example. It is assumed that the 
CYSER 170 AFIFIX already pronverty exists in user APLO as an 
indirect and public file.) 


JOBsMOVEAPL 


WHEN any_fault D0 
display_vaiue osvS$status outout=$response 
request_Loperator_action message=* AFIFIX MOVE FAILED * 
fogout 

WHENEND 


setllink attributes user=(APL) NOS) password=*aPLO 
replace_file from=%system.aot.mnaintenance.afifix + 
tozafifix de=5860 


JOBEND 


If you have been iInstallina and supoorting NOS/VE systems prior to 
Release 1.1.2» then you may be aware of the steps required to 
upgrade to a newer level of NOS/VE (specifically template 
installation). This process has become obsolete with this system. 
NOS/VE now uses the systen core and the job template from the 
deadstart media (NOS tape file or NOS disk file representing 
TPXXXK) as the source for any instance of NOS/VE deadstart. 
Consequentiys, the systen core conmands 'USESJT® and PUSERJT!? (Cand 
their associated tong forns) have been deleted from the system 
core command repertoires! Tnhereafores, these commands need to be 
removed from a site's DCFILE. 
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This means that to perform an upgrade deadstart»s one merely needs 
to use the new deadstart file and perform aocontinuation 
deadstart,. 


6s Interim Remote Host partner jobs are submitted as batch origin 
jobs with the advent of NOS 2.32 Problems with the commands 
GET_FILE and REPLACE FILE occur when the NOS system batch job 
limit is set too low. This could cause GET_LFILE and REPLACE_FILE 
to fail with the error message "JNABLE TO COMMUNICATE WITH NOS 178 
REMOTE HOST". What happens is that when doing one of these 
commands, a partner job gets spun of f and is submitted as a batch 
Job to NOS. If there are enough batch jobs running to reach the 
batch job limits the vartner fob will be put in the NOS input 
queue to wait for one of the batch jobs to finish. The 189 side 
waits for the partner job to Finish. If the 180 side does not get 
a response from the partner jod within 10 minutess then it will 
time out and Issue the error message abovee To get around this 
problems we recommend that the batch limit be set to 20 to 50 or 
more depending on the use of file transfer through Remote Host and 
Interstate Communication In your systeme The maximum number of 
Remote Host and Interstate Communication jobs that can be running 
at one time is 50. 


NOTE: Interstate communication jobs do not time out on the 186 
Side. They will wait untit the partner job gets rolled tn and 
Finishes before they continue one, 


7. The NOS/VE Analysis Manual (59463915) contains discussion on the 
events that take piace within NOS/VE for the different types of 
deadstarts performed by NOS/VE. One of the types of deadstarts is 
a recovery deadstart which is parformed primarily after NOS/VE has 
been terminated ody the TERMINATE_SYSTEM command. The purpose of 
the recovery deadstart is to assure that ali mass storage 
transactions in central menory have been processed to update the 
mass storage device (i.e2.» central memory and mass storage agree 
on the state of a file). 


The NOS/VE Analysis Manual incorrectly implies that one enters the 
‘INITDD* command when the ‘ENTER SYSTEM CORE COMMANDS? prompt 
appears during a recovery deadstart (if operator intervention is 
selected). Note that this is incorrect and will not be accepted 
by NOS/VE. An appropriate error message will be displayed 
C*INITOO NOT ALLOWED DURING RECOVERY't) and NOS/VE then awaits any 
additional system core conmands (i.e.» "AUTO'). 
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NOS/BE INSTALLATION 


To login to NOS/VE from an interactive terminal» you must first be 
validated to tog in to NOS/BE INTERCOM 5.X. INTERCOM users are 
validated by use of the PASSWRO utility as described in the NOS/BE 
Installation Handbook. In order for an INTERCOM user to log in to 
NOS/VE»s he must have a valid NU/VE user name as one of his 
INTERCOM password parameters. The user must enter the following 
command after logging in to INTERCOM in order to tog in to NOS/VE? 


veiaf 


The VEIAF utility ais an INTERCOM multi user job which witli take 
the NOS/VE user name for the current INTERCOM user from the 
Password file and initiate a togin sequence with the NOS/VE 
Interactive Facility. After successful logins NOS/VE messages 
similar to the following aili be displayed: 


Weicome to the NOS/Ve Software System. 
Copyright Control Data 1984. 

C170-855 SN2. NOS/VE RI. 

September 13s 1984. 1234 OM, 


VEIAF will continue to function as the interface between the 
INTERCOM user and the NOS/VE Interactive Facility until the 
session is complete. 


Interactive processing on NOS/VE in a NOS/BE duale-state 


environment is as described in the SCL for NOS/VE_Systam_ Interface 
Manual with the exception of the interactive control of commands, 


NOS/VE recognizes both a nause break and a terminate break 
condition. INTERCOM 5.X recognizes only one break condition which 
is caused by entering "ZA' at the terminal. Use of "ZA" will 
cause the currently executing NOS/VE command to enter a pause 
break condition In order to effect a terminate break conditions 
the user must first enter "7A' to enter pause break followed by a 
TERMINATE_COMMAND(TERC) to terminate the suspended command. 


The NOS/VE GET_LFILE and REPLACE_FILE commands used to access 
170-side permanent files have been modified to include NOS/BE 
cycless passwordss and ID's. NOS/8E files accessed with tiese 
commands must be resident on the default permanent file set. 


The format of the GET_LFILE conmand is as follows: 


SOFTWA 
NOS/VE 
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GET_LFILE(GETF) 

TO=file reference 

CFROMename] 
CDATALCONVERSION«keyword value) 
C[ID=name] 

CPASSWORD=fist Lee2 of namel 
CCyCLeE=integer 1..999) 
CSTATUSsstatus variabie] 


The FROM(F)s» IDCID)» PASSWORD(PW) and CYCLE(C) parameters specify 
the same information that would normally be supplied on a NOS/BE 
ATTACH command. That iss FROM specifies the file to ba accessed» 
ID specifies the file ids PASSWORD specifies a list of up to two 
passwords that may be supolied in accessing the file (turnkey and 
read permissions are the only passwords that would be meaningful 
for a GET _FILE command)» and CYCLE specifies the NOS/BE file cycle 
number. The system generates the NOS/BE ATTACH command using 
these values ands if access is agranteds copies the file to a 
NOS/VE file. 


The TO(T) parameter specifies an SCL file reference. If the FROM 
parameter is omitteds the File specified by the TO parameter is 
used (since the NOS/BE oermanent file structure uses only one 
catalog» just the File nane part of the file reference is ase to 
access the NOS/BE file). 


The ID parameter is not reayired if the NOS/BE file id is the same 
as the current NOS/VE user ‘amas or user name specified in the 
fast SETLLINK_ATTRIBUTE command. The PASSWORD parameters are 
required only if turnkey and/or read permissions are required to 
access the file. The CYCLE parameter is required onty if the file 
being acauired is not the highest cycle catatoged. 


The REPLACE_LFILE command is used to copy a NOS/VE file to a NOS/BE 
file. The file on the NOS/85 system can be an existing or new 
Dermanent file. 


If no NOS/BE file of the same name and id exists, a new file is 
created. 


If a NOS/BE file of the same name and id exists» anew cycle of 
the file is created. If creation of a new cycle would result in 
more than 5 cycles» the lowest cycle of the file will be surged as 
part of the REPLACE_FILE operation. 
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The format of the REPLACE _FILE command is as follows. 


REPLACE _FILE(REPF) 

FROM=file reference 

C(TO=namej 
CDATA_LCONVERSION=keyword valuel 
{ID=nanel] 

CTURNKEY«name] 

CXR=namel] 

CSTATUS=status variable] 


The TOUT)» IDCID)»s CYCLE{T)» TURNKEY(TK) and XR parameters specify 
the same information that woutd normally be supplied on a NOS/BE 
CATALOG command, That is» TD specifies the file to be cataloged» 
ID specifies the file ids TURNKEY and XR{controls extend and 
modify) specify NOS/8& oermanent file permissionss and CYCLE 
Specifies a NOS/BE file cycle number. The system copies the file 
to the NOS/BE default permanent file set and generates a CATALOG 
macro to make the file permanent. 


The FROM parameter specifies an SCL file referencee If the TQO(T) 
parameter is omitteds the file specified by the FROM parameter is 
used and the file name part must conform to NOS/BE permanent file 
naming conventions» except the length will be tLtimited to 31 
characters. 


The ID parameter is not required if the NOS/BE file id Is the same 
as the current user name@xs ar name specified in the last 
SETLLINKLATTRIBUTE commande. The CYCLE parameter is required only 
if a specific cycie of the file is to be replaced. 


The TURNKEY parameter is required onty if the user desires to 
prevent vent ali access to the file unless the turnkey password Is 
specified. The XR parameter is required if the user desires to 
allow read permission only unless the XR parameter is specified. 
If turnkey and/or XR passwords are specified when a NOS/BE file is 
Initially created» they must be specified in all subsequent uses 
of REPLACE_FILE on this file. 


A NOS/VE job can be submitted fron NOS/BE by creating a NOS/BE 
file containing a NOS/VE Job =tImage and using the NOS/BE ROUTE 
command with a logical id of NYE to submit the job to the NOS/VE 
input queue. The format of the ROUTE command for this operation 
is as follows. 
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ROQUTEC FilesDC=INsSTFNVE) 


The NVE LID must not be defined for the host NOS/BE system or it 


will attempt to process the NOS/VE jobs as NOS/BE jobs. 
5. NOS/BE support of the SETLTERMINAL_LATTRIBUTES command is as 
follows? 
ae The following parameters have fixed values that can not he 
changed 
ABORTULINE_ CHARACTER zS 
BACKSPACE CHARACTER BS 
CANCEL _LINE_ CHARACTER CAN 
CARRIAGE _RETURN_IDLE fe) 
ECHOPLEX i) 
INPUT_LDEVICE keyboard 
LINE _FEED_IOLE 9 
NETWORK. CONTROL_ CHARACTER ESC 
QUTPUT_DEVICE display 
DUTPUT_UFLOW_CONTROL none 
BUTPUT_TRANSLATION none 
PAUSE BREAK _CHARACTER ZA 
TRANSPARENT _DELIM_SELECTION (truesfalsesfaise) 
TRANSPARENT _LEND_CHAR ACTER CR 
TRANSPARENT _CHARACTER_COUNT 2044 


parameters 
class prior to 


De The following 
the terminal 
be changed: 


HOLD_UPAGE 
PAGE_LENGTH 
PAGE _WIDTH 
TERMINAL CLASS 


ce The PARITY 
changed by 
transparent 


the 
mode 


NOS /VE 


force the default terminal 
the parity bit is set 
delivered. 


d. The TERMINATE_ 


parameter is based on terminal 
users 
has been selected. 

requires a parity setting of NONEs any 
parity to be used. 


class» 


but has no effect un 


other setting 


zero before input 


BREAK CHARACTER is not supported. 


are set by INTERCOM according to 
logging in to NOS#VE» and cannot 


it may be 


less 


True transparent mode 


will 


In all casesys 
data 


is 
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ee. TYPE_LAHEAD Is always true. 
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323 NOS/VE_ EXECUTIVE 

Le. NOS/VE will not support sore than 19 tasks concurrently defined 
per job. The system does not anforce this timit3 users must be. 
careful not to exceed this timit or they may cause the system to 
hangs . . 
RSE NVEA133 
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3-4 OPERATOR COMMANDS 


1. 


Le 


Resear ene IRHF and IFEXES on the 180 Side 


TRHF moves NOS/VE input and output from and to NOS. It has a NOS 
partner job also called [RHF. IFEXEC is the NOS/VE interactive 
task. It has a NOS partner job called PASSON which is the NAM 
application VEIAF. 


IRHF should automatically restart if it aborts. To bring up IRHF 
manualliys the operator must First bring down IRHFs then bring it 
up againe The same holds true for IFEXEC. 

To bring down IRHF», enter at the 189 NOS/VE operator's console: 


DEACTIVATE_SYSTEM_TASKS TASK _ NAMES=RHINPUT 
DEACTIVATE_SYSTEM_TASKS TASK NAMES sRHOUTPUT 


Then to bring IRHF back uo» enter at the 180 NOS/VE operator's 


console 


ACTIVATE_LSYSTEM_TASKS TASK_NAMES sRHINPUT 
ACTIVATE_LSYSTEM_TASKS TASK _NAMES sRHOUTPUT 


To bring down IFEXECs enter at the 180 NOS/VE operator's console: 
DEACTIVATE_SYSTEM_TASKS TASK _ NAMES #IFEXEC 


Then to bring IFEXEC hack uo» anter at the 18060 NOS/VE operator's 
console: 


ACTIVATE_LSYSTEM_TASKS TASK NAMES @IFEXEC 
Restarting IRHF and PASSON on the NOS Side 
To make provisions for restarting IRHF and PASSON»s two procedures 
have been provided. These are MSSIRHF and MSSPASS and are ftocated 
in User Index 377777. 


IRHF is restarted by sinpty typing the following in at the 176 
operator's console? 


MSSIRHF. 


PASSON Is restarted by entering? 
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MSSPASS. 
Note: Changes were made to orocedure RUNJOBS to allow for PASSON 
to restart itself whenever it aborts abnormaiiy. If PASSON aborts 
abnormallys the systen will attempt to restart PASSON 
automatically. If NAM go2#s downs PASSON will not be automaticaily 
restarted. 


The NOS application (VEIAF) that connects NOS/VE jobs to NAM) will 
sometimes produce the flashing console message? 


"PASSON ABNORMAL 18” 


This message means PASSON is discarding an unsolicited message 
generated between VEIAF and the first read request from NOS/VE. 


This should be ignored. ‘Tilear the message with 'GO»s jsn.! 

See Section 3.921 for PASSON diagnostic messages. 

The operator should aot enter any command at the operator's 
console that requires a naagnetic tape. This will generally yield 
a deadlock condition. At! requests should come from other than 
the system job. This will permit assignment of equipment from the 
operator's console. ; 
Restarting IRHF on the NOS /3E side. 


To make provision for restarting IRHFs an operator initiated 
procedure has been provided. Simoly type: 


nneX RUNIRHF. 
where nn is a clear controt point number. 
PASSON Abnormal Processing (NIS/5E) 
During periods of heavy interactive usages the message; 
PASSON ABNORMAL 
may appear on the NOS/BE job status (B) display. Uniess related 


to a problem that auser has reporteds this message does not 
necessarily indicate an error condition. 
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8. 


9e 


10. 


When PASSON ABNORMAL appears on the system console screens record 
the number of the message for your site analyst's use. 


If your analyst asks you to examine the dayfile of the PASSON jobs 
enter the following command? 


AzNN. 


NN is the control point number of the PASSON job. 


Examine the dayfile for the nessage. The message format is? 


HEX DATA FOR PASSON CONDITION=MESSAGE NUMBER 


The message is followed by one or more lines of hexadecimal 
data which your site analyst may ask you to record. 


See Section 3.9.1 for PASSON diagnostic messages. 


The INITIALIZE_DEADSTART _ DEVICE system core command and the 
INITIALIZE_MS_ VOLUME Logical Configuration Utility subcscommand do 
not warn the operator that thea volume has been previously 
initialized. This is af particular concern in 
INITIALIZE_MS_ VOLUME because the operator may misspell the 
elementuiname of the device and itnadvertentiy destroy permanent 
files. 


In order to freeze the disolay on the NOS/VE operator's console 
while it is rapidly updating» we suggest using the "SETUP? keys 
Pressing the "SETUP! key will cause the console to stop accepting 
data from the host which will innediatety halt the display. The 
lower two lines will be temporarily overwritten with the setup 
option displays Pressing the "F1!' key will altow the display to 
resume updating. 


If the operator accidentally assigns a VE tape to the wrong VE 
jobs then no indication of this situation is given and the tape 
remains attached to the (wrong) job until it ends. 

PSR NVOE854 


There are two operator conmands available for manual job swapping. 
These are 

SWAPOUT <JSN> and 

SWAPIN <JSND> 
<JSN> is the system jood name of the job to be swapped. 
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If the job is to be swapped in» using the DISSJ command will 
provide the JSN necessary for the SWAPIN command. When a job is 
swapped out using the SWAPQUT commands it will remain swapped out 
until the SWAPIN command is executed. 


11. When an operator makes an error on an ASSIGN DEVICE (ASSD) 
commands the tape request message will be replaced by an error 
message. The operator should acknowledge the error by entering 
the REPLY_LACTION (REPA) command with the appropriate job name. 
The error message will be cleareds and the original tape request 
message will reappears allowing the ASSIGN DEVICE to be retried. 
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3.5 CONFIGURATION MANAGEMENT 
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a 
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De 
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The physical and logical configuration utilities can only be 
invoked by name from the systen console. Ali other users must use 
the EXECUTE TASK command as shown here: 


EXECUTE_TASK STARTING PROCEDURE = MANAGE_PHYSICAL CONFIGURATION 


The name ALL is a reserved alement name and should not be used in 
any element definitions. 


When running the Physical Configuration Utility (PCU) from an 
interactive terminals the include file command will return an 
error stating that the included file is not callable.» In order to 
test the configurations enter the PCUs, then copy the test file to 
another focal file. You now can include _file the new tocai file. 


Serial number uniqueness. is now enforced by the Physical 
Configuration Utility. When defining elements in the 
configuration prolog»s care must be taken to specify a unique 
serial number for each elamant. The only exception to this is for 
nulti-soindie devices such as 885-1x. 


For 830 dual CPU installation to run NOS/VE dual CPUs, ahen "ENTER 
SYSTEM CORE COMMANDS* aopears on the NOS/VE operator consoles 
enter the following: 

SETSA ENABLE_MULTIPROCESSING 1 


This command is temporary and wilt be removed in 1.1.3. 


NOS/VE cannot run on CPU 1 of a dual CPU configuration if CPU CG 
is off or down. 


The following error messages are not included in the diagnostic 
manual for Ri.~1.2: 


m~ERROR@“-THE ACTIVE LOGICAL CONFIGURATION IS EMPTY. 


Product Identifier: CM soanditions 350410 
Condition Identifiers CMESLOMLEMPTY_LC 


Description: The ftogical configuration was defined before the 
physical configuration in the configuration prolog. 
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User Action? Define the physical configuration in the 
configuration prolog before you define the logical 
configuration. 


~“ERROR@--INCOMPATIBLE LOGICAL CONFIGURATION FILE. 


Product Identifier: CM condition: 356405 
Condition Identifier: CMESLCM_ INCOMPATIBLE LC 


Description? Encountered an internal fiie oroblem. 


User Action? Reexeacute the logical configuration utility. If 
the error reoccurss execute both the physicat and togical 
configuration utilities to define the physical and togical 
configurations. If the error persistss contact Control Data 
field support 


“~ERROR--PERMISSION NOT GRANTED FOR {text}. 


Product Identifier: CM conditions 350435 
Condition Identifier: CMESLCMH_RING_VALIDATION_ERROR 


Description: User does rot have ring privilage to execute the 
program interfaces or command, 


User Action: Request tre appropriate ring privilege from the 
family administrator. 


~-ERROR——-{text} MISSING IN PHYSICAL ADDRESS SPECIFIER SET. 


Product Identifier: CM condition: 350435 
Condition Identifier: CMESLOCM_MISSING_PA_LSET_MEMBER 


Description: Missing reaguired set vaiue in the physical address 
specifier set. 


User Action: Specify the aporonvriate set value in the physical 
specifiers ise. to query controller names you need to specify 
cmc$channel and ecmcecs$chanrinel_address on the physical address 
soecifier set. 


m-ERROR--{text} 


Product Identifier: CM condition? 350455 
Condition Identifier: CMESLOM_NOT_ AVAILABLE 
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Description: User is trving to use a feature not yet 
implemented. 


User Action: Contact Control! Data Central Software Support. 


36 DEVICE MANAGEMENT/ZRECOVERY 


1s 


Ze 


If any disk volume being used by NOS7VE becomes fulls the 
following message will periodically appear on the console? 


AAAAAA =- out of space (date) (time) 
(AAAAAA is the vsn of the volume) 


Any task that is requesting space on a full volume will hang 
waiting for space. Some space may be obtained by asking users (if 
they are ab!ie) to detete permanent Files and detach locai files. 
If the disk full condition persists» the NOS/VE system should be 
taken down and brought back upe This action will release most of 
the temporary file space that was in use. If the disk full was 
caused by permanent filess then the disk will be neartiy full after 
the recoverys and the archiving of permanent files or deleting of 
some files must be done as soon as the system is up. 


It is ovossible that a disk full situation will occur that cannot 
be recovered. This wil! have happened if the "out of space” 
message appears during a deadstart before the system is up (this 
usually will occur during the voermanent file reorganization phase 
of deadstart -—- recognized by the “of recovery" message at the 
console). In this case permanent file volumes must be initialized 
and reloaded from a previous backup dump. 


If a continuation deadstart faiis after disk full with a NDS/VE 
CPU monitor faults it is opossible that the failure is due to 
unprinted files in the sutout queues one or more of which are no 
Jonger printable. The failure is a job mode software failure and 
does not leave the Monitor Control Register set in monitor mode. 
The message indicating this failure is "HR - MONITOR FAULT". 


Remedial action: 


Perform a continuation deadstart (with W2TRUE so you can enter 
system core commands) and enter the following system core command? 


SETLSYSTEMLATTRIBUTE HALTRING 9 
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This command will atlow deadstart to complete. If you find that 
task RHOUTPUT has terminated (by looking at the system job tog 
with DISSt)» and files exist in the job output queue (DISC 
SSYSTEM.~SJOB_LOUTPUT_QUEUE) you can be reasonably sure that you 
have encountered this problem. 


Delete the contents of the job output queue {DELCC. 
SSYSTEM»*SJOB_DNUTPUT_ QUEUE) > terminate NOS/VE» jgand do another 
continuation deadstart, 


367 PERMANENT FILE UTILITIES 


1. The power of the family administrator has been extended to allow 
backing up and deleting files for users in his family. 


3-8 COUNAND LANGUAGE STATISTIC 


The data that gets emitted for this statistic is the time and page 
faults for the task that calis the command. If the command spins off 
a tasks then the data for that task is found under the task statistics 
and the command statistic will onfv contain the time and page fauits 
for the initiating task. 


Statistic 
Name Description 


CIL7002 Command Resources. This statistic will 
collect and generate data for every command 
executed. It should only be used for testing 
or performance information gathering. 


The information generated by this statistic 
includes? 

DESCRIPTIV= DATA - command name 

COUNTER 1 - Job node CP time 

COUNTER 2 = monitor mode CP time 

COUNTER * total page faults 

COUNTER ~ total page-ins 

COUNTER - total voage-reciaims 

COUNTER - total page-assigns 


Dh a i 
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Due to the large overhead incurred by using this statistics it is 
conditional and must be activated in the fotlowing manner? 


FROM THE CONSOLE ENTER: 


SETSA COMMAND_STATISTICS_ENABLED TRUE 
ACTS CL176002 


To deactivate the statistics, use the opposite of the above sequence. 


DEAS CL170002 
SETSA COMMAND _STATISTICS_ENABLED FALSE 


329 ONLINE MANUALS 


1. 


The installation and upgrade of online manuals is documented in 
the NOS/VE Instatiation and Uograde Usage Manual for Release 
1.122. The maintenance process is described in this section. 


The source for online manuals is being distributed to allow 
customers the capability of talloring the manuals for their site. 
Source libraries contain a ‘S$CU feature reflecting the revision 
fevel documentation changes fexample?: feature VER_1_1_1 for 
Release 1.121) This not onty gives the benefit of a “revision 
packet" to identify new capabilities and changes», but aiso aids 
the update process for the site version of manuals. 


To tailor a manual for a site? 


ae Create a new source library or additional cycle of 
$systememanuais.maintenance.source_ library reflecting the 
Site modifications. {Note that each manual is contained in 
a deck. Decks are grouped by product.) 


be Execute $system.manuals.aaintenance.binding_procedure within 
the system user or maintenance user name to create new 
manuals. 


PROC bind manuals» binns bind manual 
manuals manuals», ni LIST OF NAME or KEY all = all 
source_cataiogs Sct FILE = $SYSTEMs»MANUALS.»MAINTENANCE 
catalogs, ct FILE = SUSER.MANUALS 
status) 


wheres 


| 3~27 
SOFTWARE RELEASE BULLETIN 
: 85/03/29 
NOS/VE R1.1.2 LEVEL 630 

329 INSTALLATION AND OPERATIONS NOTES 

369 ONE INE penue’> 


manual = scu deckname({s) of manuaits) desired to be 
created 
source catalog contains the source tJibraries used for 
compilation 

catalog = resultant catalog for new manualis) 


3010 ERROR MESSAGES 


The following diagnostic messages have not been included in NOS/VE 
manuals for Rlele2. They will be Included in a future release, 


There are 28 distinct errors that PASSON indicates by issuing a 
TPASSON ABNORMAL? message at its cantrol point. The cause of each 
error and its associated error code (issued in the 'PASSON ABNORMAL? 
message) are listed below. The error explanations assume a knowledge 
of the network concepts eavinced in the NAM/COP Reference Manual 
{publication number 6049950690), ar 


Le PASSON ABNORMAL © 


PASSON's attempt to sign on to the nemory link failed with a fatal 
error status. PASSON terminates. 


2e PASSON ABNORMAL 1 
The memory tJink reported a fatal error status when PASSON 
attempted an miptadd sender to oermit itself to receive messages 
from any NOS/VE application. PASSON terminates. 

36 PASSON ABNORMAL 2 


PASSON does not begin interactive processing until NOSIVEts 
Interactive Facility's executive signals it to do so. In this 
cases the memory fink reoorts a fatal error status while PASSON is 
awaiting the executive's signal. PASSON terminates. 


4e PASSON ABNORMAL 3 


An attempt to activate network message Jogging has failed because 
the logging code is not availabie. PASSON terminates. 


Qe PASSON ABNORMAL 4 
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An attempt to activate network statistics accumulation has failed 
because the statistics accumulation code is not available. PASSON 


_ terminates. 


Be 


lle 


PASSON ABNORMAL 5 


The memory tink reported a fatal error status when PASSGON 
attempted to receive a downline message from NOS/VE. PASSUN 
issues the abnormal message and continues interactive processing» 


PASSON ABNORMAL 6 


After receiving a message from NOS/VEs PASSON has discovered that 
the message is neither a data mnessage nor a supervisory message 
(the only 2 possibilities for application messages). PASSON 
issues the abnormal message and continues interactive processing. 


PASSON ABNORMAL 7 


NAM has signaled to PASSON (via the supervisory status word) that 
an upline supervisory message is available to retay to NOS/VE» but 
PASSON ascertains that the message is not a supervisory messages 
PASSON issues the abnornal message and continues interactive 
processing. . 


PASSON ABNORMAL 8 
Not used. 
PASSON ABNORMAL 9 


PASSON has received a connection request supervisory message 
(CON/ZREQ/R) from NAM for a connection which is already in uses 
The connection request is ianored. PASSON issues the abnormal 
message and continues interactive processing. 


PASSON ABNORMAL 10 


PASSON has received an initialized-connection (EC/INIT/N) or. an 
initialized-connection request (FC/VINIT/R) supervisory message 
from NOS/VE or NAM» respectively» and the connection receiving the 
message is not at the appropriate stage of the connection 
initialization sequence. PASSON places a connection in a state of 
waiting for an FC/INIT/& (after a CUON/REOS/N) or an FO/INIT/N 
{after an FC/INIT/R). In this case the connection is not in the 
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13. 


1i4¢. 


15. 


16. 


17+ 


wait State when the FC/INIT/2 or FC/INIT/N is received, The 
message is ignored (which will hang an uninitialized connection) 
and PASSON continues interactive orocessing after issuing the 
abnormal messages 


PASSON ABNORMAL 11 


PASSON has received a network shutdown supervisory message 
(SHUT/INSD/R) from NAM indicating that NAM shutdown is in 
progress. PASSON terminates immediately if the shutdown is 
immediates otherwise the shutdown message is relayed to NOS/VE and 
PASSON continues interactive oroacessing after it issues the 
abnormal messages 


PASSON ABNORMAL 12 


A supervisory message has bean received by PASSON from NAM that is 
not in the Jist of supervisory messages which PASSON can recognize 
and receive from NAM. The message is ignoreds PASSON issues the 
abnormal message and continues Interactive processing. 


PASSON ABNORMAL 13 
The status of PASSON is normal and processing continues. 
PASSON ABNORMAL 14 


The memory tJlink reported a fatal error status when PASSON 
attempted to send a queued ucline supervisory message to NOS/VE. 
The message is not sent and PASSON continues interactive 
processing after issuing the abnormal message. 


PASSON ABNORMAL 15 


The memory link reported a fatal error status when PASSGN 
attempted to send an upline suvervisory message to NOS/VE that was 
not queued. The message is not sent and PASSON continues 
interactive processing after issuing the abnormal message. 


PASSON ABNORMAL 16 


PASSON tried to send a suovervisory message from NAM to NOS/VE but 
had to queue the message for later transmissions but there was no 
allocatable space to queue the nessagee The message is not sent 
and PASSON continues interactive orocessing after issuing the 
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abnormal messages 
PASSON ABNORMAL 17 


The memory tink reported a fatal error status when PASSON 
attempted to send a queued upline data message to NOS/VE. The 
message is not sent and PASSION continues interactive processing 
after issuing the abdnormal massage. 


PASSON ABNORMAL 18 


The memory tink reported a fatal error status when PASSON 
attempted to send an upline data message to NOS/VE,. The message 
is not sent and PASSON continues interactive processing after 
issuing the abnormal messaqe. 


PASSON ABNORMAL 19 


PASSON has received a connection-rejected supervisory message 
(CON/REQ/A) from NOS/VE for a connection which was not in the wait 
state for a CON/REO/N. PASSON places a connection ina state of 
waiting for a CON/REOQYJN after the connection has sent a CON/REQ/R 
uptine to NOS/VE. The connection is ended and PASSON continues 
interactive processing after issuing the abnormal message. 


PASSON ABNORMAL 26 


PASSON has received a connection accepted supervisory message 
({CON/REQ/N) from NGOS/VE for a connection which was not in the wait 
state for a CON/REQ/N. PASSON olaces a connection in a state of 
waiting for a CON/REOQ/N after the connection has sent a CON/REQIR 
upline to NOS/VE- The connection is ended and PASSON continues 
interactive processing after issuing the abnormal message. 


PASSON ABNORMAL 21 


PASSON has recelved a supervisory message from NOS/VE to stop 
interactive processing. PASSON terminates. 


PASSON ABNORMAL 22 


PASSON has received a supervisory message from NOS/VE which is not 
in the tist of supervisory messages which PASSON recognizes = and 
can receive from NOS/VE. The message is ignored and PASSON 
continues interactive omrocessing after issuing the abnormal 
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24%. PASSON ABNORMAL 23 
Not usede 

252 PASSON ABNORMAL 24 


PASSON has received a data message from NAM whose message header 
has the ibu (input block undeliverable) bit sete The message is 
not sent to NOS/VE and PASSON continutes Interactive processing 
after issuing the abnormal messages 


262 PASSON ABNORMAL 25 


PASSON has received a supervisory message from NAM whose message 
header has the ibu Cinput block undeliverabie) bit set. The 
message is not sent to NOS/VE and PASSON continues interactive 
processing after issuing the abnormal message. 


27-2 PASSON ABNORMAL 26 


The memory fink reported a Fatal error status when PASSON 
attemoted to send a message (datas supervisorys queued data or 
queued supervisory) to a NOS/VE application not signed on to the 
memory link. The message is not sent to NOS/VE and PASSON 
continues interactive processing after issuing the abnormal 
message. 


28. PASSON ABNORMAL 27 
PASSON has receiyed an error-logical supervisory message 
(ERR/LGL/R) from NAM for a connection. The message is reported to 
the job dayfile for the connection and then relayed to the 
connection's associated NIS/VE application. After issuing the 
abnormal message PASSON continues interactive processing» 
3eilOe2? MEMORY LINK FATAL ERRGR CODES 


The fatal memory tink error cod2s are tisted below with corresponding 
descriptions. Those error codes not tisted are not fatal errors. 


Ll. MEMORY LINK FATAL ERROR 1 


This status value indicates that the application name of the 
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be 


receiver is not valid. Currentiys the only invalid value is i. 
The request is ignored. 


MEMORY LINK FATAL ERROR 2 


This status value indicates that the application name of the 
sender is not valid. Currentivs the only invalid vatue is 1. 
The request is ignored. 


MEMORY LINK FATAL ERROR 3 


This status vatue indicates that the receiver application is not 
currentiy signed on to MLI. The request is ignored, 


MEMORY LINK FATAL ERROR 4 


This status value indicates that the application name specified is 
Signed on to MLIs but by a different task than the one making the 
requests ieess, the requesting task is not the ‘owner! of the 
application, The request is ignored. . 


MEMORY LINK FATAL ERROR 7 
This status vatue indicates that an ADD_SENDER request is being 


performeds but the permit list of the receiver is full. The 
maximum number of permits is soecified by micSmax_permits. The 


request is ignored. 


MEMORY LINK FATAL ERROR 3 


This status value indicates that the sender anptication being 
referenced is not currantliy signed on to MLI. The request is 
ignored. 


MEMORY LINK FATAL ERROR 9 

This status value indicates that a SENDLMESSAGE is being attempted 
between two applicationss both of which are C170 apptiications,. 
The request is ignored, 

MEMORY LINK FATAL ERROR 19 

This status value indicates that the sender application has not 


been granted permission by the receiver apolication to send 
messages to it (CONFIRM_MESSAGE or SEND UMESSAGE request) or that a 
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DELETE_LSENDER) request is being performed for an application not 
currently permitted. The request is ignored. 


9. MEMORY LINK FATAL ERROR 15 


This status value indicates that a RECEIVE MESSAGE request has 
been mades but the buffer that is to receive the message text is 
smaller than the actual’ message. The request is completed 
normallys but only as much of the message is transferred as will 
fit in the buffer. 


10. MEMORY LINK FATAL ERROR 17 
This status value indicates that the length of the message 
specified in a SEND MESSAGE request is greater than 
micSmax message_length. The request is ignored. 

il. MEMORY LINK FATAL ERROR 21 
This status value indicates that the application has tried to 
SIGN_ON to MLI more than atcfnax lsignons_per_appl times. The 
request is ignored. 


12. MEMORY LINK FATAL ERROR 22. 


This status value indicates that the max messages parameter on a 
SIGN ON request is targer than mictmax_ queued messages. The 
request is ignored, 


134 MEMORY LINK FATAL ERROR 23 


This status value indicates that the maximum number of 
applications are currently signed on to MLI.- The reguest is 
ignored. 


14-2 MEMORY LINK FATAL ERROR 24 


This status value indicates that a SIGN_ON request has attempted, 
but the task making the request has already Signed on 
mic$max_signons_per_systen name unique applications. The request 
is ignored. 


15-2 MEMORY LINK FATAL ERROR 25 
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This status value indicates that sone sort of internal error has 
occurred within MLI. The reauest may be retrieds but the results 
are unpredictable. 


MEMORY LINK FATAL ERROR 26 


This status value indicates that a C175 MLI request has specified 
an illegal MLI function. The request is ignored. 


MEMORY LINK FATAL ERROR 27. 

This status value indicates that a C170 parameter passed to MLI by 
a C170 job was invalid. This can be due to a parameter value out 
of range or because of an address beyond the C170 fieid length. 
MEMORY LINK FATAL ERROR 23 

This status vatue indicates that a memory link request was 


performed by a Ci7G job and that the NOS/VE system was not running 
at the time. The request is ignored. 


321003 CONFIGURATION MANAGEMENT ERROR CODES 


The following Configuration Management error codes are not documented in 
the Diagnostic Message manual for R1.1.?. 


le 


Recorded vsn {text} contains more than 6 characterse 


Product Identifiers: | Condition: 3539660 
Condition Identifier: CMESCMD NAME _ TOG LARGE 


Description: 
The recorded vsn entered contained nore than 6 characters. 


User Action: 
Reenter the command using avsn of 6 or fewer characters, 


Channel number {text} is r90t in range between {text} and {text}. 


Product Identifier: cM Condition: 350665 
Condition Identifier: CMESTILLEGAL_ CHANNEL _ NUMBER 


Descrietion: 
The channel currentiy being used by NOS/VE for access to the 
system device |s not supported by NOS/VE. 
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User Action: 

Change the channel selected on the SETVE command to one supported 
by NOS/VE. Currentiys NOS/VE supports channel! numbers from 0 
through 27 (10). | 


File {file} must have page width of at least {text} characters. 


Product Identifiers cM Conditions 350735 
Condition Identifiers: CMESPCULILLEGAL_ OUTPUT_FILE 


Description’ | 
The output file must have the specified minimum page width. 


User Action: | 
Change the file attributes to have a page width of at tleast the 
specified size. 


Product identification {text} is unknown to the system. 


Product Identifier: cy Condition: 356779 
Condition Identifiers: CMESPCU_UNKNOWN_ PRODUCT_ID 


Description: 
The product identification soecified is not currently supoorted. 


User Action: 

Check the supported equipment and verify that you are using a 
supported product identifier. 

Unable to allocate the active volume table in procedure {text}. 


Product Identifier: cM Condition: 350602 
Condition Identifier: CMESPC_ALLOCATE_LAVT_LERROR 


Qescription: 


An active volume table for devices besides the system device can 
not be allocated, 


User Action: 
Redeadstart the system. [f the condition persists» contact a site 
analyst. 


Logical unit C€text} is not in the physical configuration table. 


Product Identifier: | Condition: 350640 
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Condition Identifier: CMESPC_LUNTTLUNOTLUFOUND 


Description: 
The element described by the given togical unit number is not 
present. 


User Action: 
Retry the request. 


CPU MAINTENANCE PROCEDURES 


Included with NOS/VE standard products is the Diagnostic Virtual 
System (DVS). OVS is a utility which centrots on-line diagnostic 
test execution under NOS/VE. Programs used by DVS are enhanced 
versions of off-line diagnostics. These diagnostics employ the 
same testing strategy» but contain unique code for on-line 
inter facing. 


Usage 


DVS documentation is available in the form of a printed usage 
guides pubiications number 69469720 revision 8B. It is also 
documented in an on-line version of the usage guide. The on-line 
guide is contained on file DVS_USAGE in the HARDWARE_MAINTENANCE 
subcatalioge To use the guide enter: 


EXPLAIN M=S$SYSTEM*HARDWARE MAINTENANCE s«DVS_USAGE 


Notes and Cautions 
The DEBUG hardware test ()8UG)» although documented for release 
lele2s will not be released until 1.1.3, 


When using DVS with Dual Processor Cyber 830's»s it is possibie to 
create a situation where DVS obtains most of the CPU resource when 
a specific processor is selected for testing. It is recommended 
for concurrent operations that you do not select aie specific 
processor. 


When using OVS with Cyber 845/855 systems» diagnostics BIMM and 
NUMR detect known BOP end-case failurese Using 
RUN-CPULDIAGNOSTICS autonatically detects the processor type and 
will not run these tests. Howevers when manually selecting tests» 
it is recommended that these tests not be run until the 
appropriate FCO's are instatied. 
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4. When uSing DVS with Cyber 8457855 systems» diagnostic RFST detects 
known BDP end-case Failures. When using the RUN_DVS commands you 
should not alter the RFSTLDELETE_3DP parameter. It is IMPARATIVE 
that this parameter remain at its default setting until 
approoriate FCO's are installed to correct the end-case failures. 
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4e1 SYSTEN_ COMMAND LANGUAGE 


1. A command that depends on the "nath name” for a file is affected 
if the file has been explicitty attached (attach_files create_file 
commands). 


The "path name” that sucn a command will encounter is the “local 
path name" rather than the path specified when the command was 
called. For example? 


ATTACH _ FILE SUSER.X LFN=Y 
REPLACE_FILE SUSER.X 


will result in a file called Y being referenced in real state 
rather than X. Users should not mix implicit and explicit use of 
a file. 

PSR NVOD753 


2 The S$PROGRAM function does not return the open position designator 
for the LOAD_MAP file. 
PSR NVOD483 


3. The SETLSENSE_SWITCH (SETSS) command will not accept a “user 
supolied job name" but will only work when given a "system 
supplied job name", 

PSRs NVODB871» NVOD888 


4. The constants $MIN_LINTEGER and SMAX_LINTEGER have values of 
~(2**48-1) and 2**4B-1» respectively» rather than ~—-(2**63) and 
2**63—-1,. 

PSR NVOD609 


5. Any files created by the orogram interface cannot be displayed 
with DISC $LOCAL. For examoles the default files created in 
FORTRAN do not appear when subsequently entering DISC $LOCAL. 

PSRs NVEAOS2s NVEAOD55» NVEAD56 


6.e JOB/JOBEND reformats data lines which end in two periods. The 
problem is that JOB/JQOBEND treats lines ending in two periods as 
command tines to be continued and writes the concatenated form of 
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the command iine to the File it submits as a job. This is usually 
only ao problem if the job contains a usage of COLLECT TEXT. In 
this cases» the file could be created before using JOB/JOBEND and 
referenced in the job» rather than creating the file within the 
Jobe. 

PSR NVOF327 


7+ In the process of implementing improvements to 
DISPLAY _COMMAND_LISTs the command table passed to CLPSPUSH_UTILITY 
by command utilities has been changed, 


The new tables should be oroduced by using the new command table 
generator which is described in APPENDIX De 
GENerate_Command_ Table does for the new command and function 
tables what the parameter deseriotor table (PDT) generator does 
for PDTs. It takes as input a specification for the table and 
produces as output the CYSIL variable declarations that represent 
the table, 


CLPSPUSH_UTILITY expects entries in the tables it is passed to 
have been correctiy generateds untike the previous situation in 
which you could pass a table that was unsorted or contained names 
in lower case ltetters. 


New commands for displaving the command tist have also been 
implemented. Thus the information that used to be available via 
the full mode option of the DISPLAY_COMMAND_LIST command must now 
be obtained from the DISPLAY_COMMAND_LISTLENTRY command. See the 
following section on “Additional Commands" for a description of 
the new form of the DISPLAY_COMMAND_LIST commands and the new 
DISPLAY _COMMAND_LLISTLENTRY command. 


6e Two parameters have been added to the COLLECTLTEXT command 
following the UNTIL parameter. 


prompts p3: This parameter specifies the prompt string to be issued 
for each tine if collect text is getting its input from an 
interactive terminal.: If the null string is specifieds no 
prompt is issued. 


Omission causes 'CT?* to be used. 
substitution_marks sm: This parameter specifies a character that 


is used within the taxt to be collected to delimit text to be 
substituteds or that no such character be used (NONE). 
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Corresponding pairs of substitution marks must appear on the 
same line. The taxt between such marks is evaluated as an. 
SCL string expressions the result of which replaces the 
original text including the substitution marks. 


If the expression cannot be evaluated or its resuit cannot be 
converted to a strings the COLLECTLTEXT command terminates 
with an appropriate error. If no second substitution mark its 
found on a lines the end-of-line is treated as the second 
substitution mark. IF two consecutive substitution marks 
appears they are replaced by a single substitution mark iin 
the collected text. Sudstitution cannot be used to construct 
the tine containing the termination strings i.e. the 
termination string its checked for prior to processing the 
line for substitution. 


Omisston causes NONE to be used. 


9. A parameter has been added to the JIB/JOBEND command following the 
JOB_LCLASS parameter, 


substitution marks sm? This parameter specifies a character that 
is used within the statements to be collected to delimit text 
to be subdstituteds or that no such character be used (NONE). 
Corresponding pairs of substitution marks must appear on the 
same tine. The text between such marks is evaluated as an 
SCL string expressions the result of which replaces the 
original text inciuding the substitution marks. 


This capability is o»erovided because the submitted job does 
not have access to any variables or procedure parameters of 
the job that initiates tt. Therefores if parametric 
information is to be used in the submitted jobs» it must be 
substituted directty into the statements of the job. 


If the exoression cannot be avatuated or its resuit cannot be 
converted to a strings the JOB/JOBEND command terminates with 
an appropriate error. If no second substitution mark is 
found on a lines the end-of-line is treated as the second 
substitution mark. If two consecutive substitution marks 
appears they are replaced by a singte substitution mark iin 
the colfected text. Substitution cannot be used to construct 
the JOBEND delimiter. 


Dmission causes NONE to be used. 
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10. Interactive Command Language Promoting 


This release includes the initial phase of interactive prompting. 
Subsequent releases will include a more comprehensive prompting 
facitity with help modules containing messages and prompts “for 
each commande. 


For a command entered from an interactive terminals SCL issues 
prompting information to the terminal depending upon user actions 
and the "mode" in which the user is operating. 


"NORMAL*® MODE 


This is the mode under which all commands in procedures» batch 
jobs and included files are ornocessed by default -- that Iss if 
any error is detected during evaluation of the parameters for the 
commands processing of the command is terminated Immediately. 


LINE” MODE 


This mode is applicabie only to interactive jobs. Line mode must 
be explicitiy selected by the user via the SET_COMMAND_MODE 
command. ae 


This mode does not require any special type of terminal but does 
take into account certain terminal attributes such as page width. 


In tine modes the parameters entered with the command name are 
evaluated and for each detectable errors, an error message is 
written and the user is prompted to enter the correction. The 
prompting information is derived from the data In the command's 
parameter description table (PDT). 


Once all specified parameters have heen accepteds, a check is made 
to insure that all required oarameters have been supplied and if 
nots the user is prompted to eanter them. 


When entering corrections or omitted parameters» the user may 
enter more than the parameter being prompted forse This is done in 
exactiy the same way as parameters are normally given to a 
command. 


If the original call to the command did not include any parameters 
and the command has at teast one required parameters the user iis 
prompted for each parameter of the commands except those with the 
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VAR attribute that are apntionat {this includes the STATUS 
parameter). 


In response to any promot» a terminate break can be entered to 
terminate processing of the command. Also» a question mark (7?) 
can be entered to obtain information about acceptable responses to 
the prompte If a question mark is entered twice in succession in 
response to a prompt» or a double question mark (2?) is entered, 
information about how to use tine mode facilities is displayed. 


4e1.1 ADDITIONAL COMMANDS (NOT IN MANUALS) 
4elel.sl DISPLAY COMMAND. PARAMETER (3) (OTscP) 


This command displays information about the parameters for a command. 
The Information inctudes the names of the parameterss their types 
{including allowed keyword values) and their default values {or an 
indication that the parameter is required). 


This command is not intended to be a replacement for information in 
onfine manuals» but rather a "menory jogger™ for any command. It will 
work for any command that could be called at the point where this 
command is calied (inctuding system suoptied commands» SCL proceduress 
user programs and utility subconmands),. 


This command can be used to ootain information about the parameters 
for any command that uses SCL services to parse its parameters. 


display_command_parameters conmand=<conmand> 
Loutput=<file reference>d] 
Cstatus=<status variablie>] 


command ! ct This parameter specifies the command for which Information 
about parameters is sought.e: 


output $$ o: This parameter snacifies the file to which the parameter 
information is written. Onission will cause S0UTPUT to be used. 


status: This is the standard status parameter, 
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4elele2 DISPLAY COMMAND LIST _(DLSCL) 


This command displays the names of the entries in and/or the search mode 
governing the command tist. 


display command list (Cdisoplay_ootions=list of al} 3 
entriesientryie { saarch modeism] 
Coutpute<file referenced] 
Cstatus=<status variable>] 


3 


disptay options $ display option $$ dot This parameter selects the 
information to be displayed. 


ali: This option selects al! of the other options. 


entries i entry i? a: This oection causes the names of the entries in 
the command list to be displayed. 


search mode {| sm: This option causes the command list search mode 
to be displayed. 


Qmission causes entries to he selected, 


output io: This parameter designates the fille to which the information 
is written. 


Omission causes $output to be used. 
status: This is the standard status parameter. 
4o1.1.3 DISPLAY COMMAND LIST_ENIR Y( IES) (OTSCLED 


This command displays information about one or more command tist 
entries. 


display _command_fist_lentry [Lentryzlist of <file> i all } 
control _statementsicantrol statementics } 
firstif] 

Cdisplay_options=list of all $ allunamesiatinametan 3 
commandsicommandic | functionsi function f 
namesinamein] 

Coutout=<file referenced] 
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Cstatus=<status variable>]. 


entry $ entries ! et This parameter selects the command list entry or 
entries to be displayed. Any entry that can be put in the command 
dist can be selected regardiess of whether it is presently in the 
command fist. In addition the following keywords can be used to 
make generic selections. 


ali: This option selects the entire command list for display (this 
includes the control statements). 


control statements  $ control statenent i} cs: This option selects 
the control statements and commands inherentty part of SCL. 


first i f3 This option selects the first entry in the command list. 
This provides a way of selecting a display of the subcommands 
supplied by a utility when the utility is active. 


Omission causes first to be used, 


display_options { display option { do: This parameter selects the form 
and content of the output. 


all: This option selects al} of the other options. 


alil_names j}{ alluname 3; ant This option causes all of the names 
(abbreviations and aliases» as weil as the “nominal” names) of 
commands and/or functions and/or control statements to be 
displayed. 


commands i command } ct: This option causes information about the 
individual commands within the selected command tist entries 
{other than catalogs) to be displayed... 


functions } function ! f: This option causes information about the 
individual functions within the selected command list entries 
to be displayed. 


names } name } nt This option causes the “nominal” names of 
commands and/or Functions and/or control statements to be 
displayede A “nominal” name is the name by which the commands 
function or statement is nornaliy known, 


Omission of this parameter causes commands and names to be 
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selected. Omission of both commands and fuactions Causes commands 
to be selected, 


output 3 0: This parameter designates the file to which the information 
is written. 


Omission causes toutput to be used, 
status? This is the standard status parameter, 
4eleiet SETDEEAULT_EAMILY (SETIED 
This command provides the operator with the capability of establishing a 
default family for jobs» Tais command affects all jobs except those 
initiated via the JO3/JOBEND conmand. This includes jobs RDOUTEd from 
the NOS system. 
NOTE that prior to the availability of this commands jobs submitted via 
the SUSMIT_J0B command wouid have defaulted the family to that of the 
Submittor -- this is no longer true. 
If this command is never issueds the default family name is SSYSTEM. 


set _default_family family name=Cnane> 
{Cstatuss<status variabie>] 


fanily_ name 4 fn: This parameter specifies the name to be used as the 
default vatue for the family_name parameter of the LOGIN command. 

status: This is the standard status parameter. 

4e1.1.5 SETLCOMMAND MODE (SETCM) 


This command determines how subsequent commands entered from a terminal 
will be handled in the event of incomplete or incorrect parameters. 


set _command mode mode=lineilinormatin 
status 


modes m: This parameter specifies the command mode being selected. 
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status: See ERROR HANDLING. 


41.1.6 CHANGE NATURAL LANGUAGE (CHANL) 


This command determines the preferred natural language to be used for 
messages» heip informations etc. 


change natural languages chani { 
natural _Janguages ni: any of 
key 
danish 
dutch 
engiish 
finnish 
french 
german 
italian 
norwegian 
portuguese 
spanish 
swedish 
us_engliish 
keyend 
name 
anyend = %Srequired 
status) 


natural language: this parameter specifies the natural language being 
selected. 


status: See ERROR HANDLING. 
4.1.2 ADDITIONAL FUNCTIONS (NDT IN MANUALS) 
G4eole2e1 SCOMMAND SOURCE 

This function is used to determine where the processor for the 
requesting command was found. The source (file or catalog) of the 
command is returned as a strings: 

By its natures this function is not oarticularly useful wnen used in 
the expression for ao parameter to a commands sinces in that cases it 


will return the source of that conmand. Therefores this function is 
normally used in an assignment statement. 
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<$command source> 3:3= $COMMAND_ SOURCE C<0> <)>] 


Exampie? "The following proc resides on an” 

"object library in some eauereds 

PROC sample command 
cs = $command_source 
cat = $path($fname(cs )» catalog) 
"The following command executes file” 
“sample program in the sane catalog" 
execute task tfname{cat//'.sample program!) 

PROCEND 


%eols2e2 $PREVIOUS_ STATUS 


This function is used to obtain the conptetion status of the previous 
command. 


<$previous _status> 22= S$PREVIOQUS_ STATUS [<> <)>] 


Cxamole: collect text display_status 
PROC display _statuss diss { 
status: status = Sprevious status) 
display value Svatue(status) 

PROCEND display status 
Pe 
create variable s kind=status 
create _variable x status2s 
display status 
NORMAL STATUS 
create _variable x status=s 
display wstatus 
~m-ERROR-- X is already declared as a variable. 


Note: there are certain status conditions that do not cause 
SPREVIDUS_ STATUS to return the expected value. Among these are error 
from contro! or assignment statement and "xxx is not a command”. 

PSR NVOFO7?7 

4.1.2.3 $QUDTE 


This function is used to quote a string. 


<sauote> 3:23" ZSQUOTE <(> <string exor> <)> 
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Example: s = "taABCTIDEF? 
q = $quote(s) 
disolay_value s 
ABC'DEF 
display_vatue q 
TABCTIDEF! 


This function is used to search a string for any one of a set of 
characters and return the index in the string of the found character, 
If no character from the set apoears in the strings zero is returned. 


<$scan_any> 3:32 SSCAN_LANY <(> <char sat> <sispd 
<string exor> <)> 


<char set> t:= <string expr> 


Examples: digits = 10123456739! 
s = #TEMP_32! 
dispitay value t$scan_any(diagitss s) 
6 


4ele2e5 S$3CAN_NOT_ANY 


This function is used to search a string for any character that is not 
in a set of characters and return the index in the string of the found 
character. If only characters from the sat appear in the strings zero 
is returned. 


<$scan_not_any> 232 SSCAN_LNOT_LANY <(> char set? <sisod 
€string expr> <)> 


<char set> 332 Cstring expr> 


Exampie: digits = '01234567898 
s = *TEMP_ 32? 
display_value $scan_not_anyldigits»s s) 
i 
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4ele206 $SCAN_ STRING 


This function ts used to search a string for another strings called the 
pattern, and return the index of the first character of the pattern in 
the stringe If the pattern is the null strings a value of one(l) is 
returned. If the pattern is not Found in the string» a value of zero 
(0) is returned. 


<$scan_string> t3= $SCAN_ STRING <{> Cpattern> <sisp> 
€string exor> <)> 


<pattern> ::= <string expr> 


Example: s = '123_abc_9! 
p = "abc! 
display_value scan ustrinalos 3s) 
5 


4ele2e7 STRANSLATE 


This function is used to change characters in a string according to a 
translation table. The transtation table is a string of 254 characters 
which is utilized according to the Following algorithm. 


result = 9 
For i = 1 to $strien (string) do 

J = Sord($substri(strings 1)) 

result = result // Ssubstr(tables j+1) 
forend 


Two standard translation tables are provided. Use of LOWER -TO_LUPPER 
(LTU) produces a string with all lower case Jetters transtated to their 
upper case counterparts. Use of UPPER TO_LOWER (UTL) produces a string 
with all upper case letters transtated to their tower case counterparts. 


<$translate> :3= $TRANSLATE < (> <transtation tabte> <stispd 
string exor>d <)> 


<translation table> :3= “string exor> 
+ LOWER LTI_UPPER 3 LTU 
5 UPPER_TO_LLIOWER $ UTL 


Examples display_value Stranstate(lower_to uppers "123 abc!) 
123_A8C 
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%o1.22e8 $ITRIM 
This function is used to remove trailing space characters from a string. 
<$trim> 332 STRIM <(> <string expr> €)> 


example: s = 'STRING ? 
displayivatue *<t//s/s'>? 
<STRING > 
display wvalue '<'//$trin(s)//7%>!? 
<STRING>D 


1.3 ADDITIONAL CONTROL STATEMENTS (NIT IN MANUALS) 
4.1.31 PUSH COMMANDS 


<push commands> %3= PUSH COMMANDS 


The purpose of this statement is to cause the source (file or. catalog) 
of the issuing command to be pushed onto the top of the "dynamic command 
jist”. The entries in the dynanic command list are searched after the 
commands belonging to any active utilities and before the command fist 
entries manipulated by the SETLSUMMAND_LIST command. The effect of this 
statement is removed (popped) when the issuing command terminates. 


4e124 ADDITION CYBIL PROGRAM INTERFACES (NOT IN MANUALS) 
4o1.4.1 AMPSREPLACE_ PREVIOUS RECORD 


The purpose of this request is to rentace an entire record. This 
request is valid onty for nass storage files opened for sequential 
record access» The file position must be at the end of the record to be 
replaced. The file position r2amains at the end of the record replaced. 
The tength of the replacement record nust be identical to the length of 
the previous record for a file whose record-type is COC-variabie (V). 
Note the fength of the previous record is exclusive of V record-headerss 
i.e» oniy the togical tlength of the records must be identical. 
Therefores a record output with a series of partial PUTs can be 


replaced. For a file whose record-type is ANSI-fixed (F)» the 
replacement record will be truncated to maximum-record-jength, if the 
replacement record exceeds maximum-record<tength. The length of the 
repJacement record must be less than or equal to the 


maximum—bilock=-length for a file whose record-type is undefined (U) and 
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whose block-type is user<-spacified. Note that a record deleted by oan 
anp$delete_ previous record request cannot be replaced because one cannot 
position to the end of a deleted record. This request is not supported 
for a file whose record-type is ueeean {(U) and whose block-type is 
System—specified. 


This request requires 'modify!t access to the file. 
FORMAT? 


AMPSREPLACE_PREVIOUS_RECORD (FILE IDENTIFIER» 
WORKING STORAGE_AREA,» WORKING _STIRAGE LENGTH» STATUS) 


FILE_LIDENTIFIER: (input) This parameter specifies the file access 
identifier established when the File was opened. 


WORKING _STORAGE_AREA: (input) This parameter specifies the address of 
the record which is to replace an existing record of the file. 


WORKING _STORAGE_LENGTH: (inout) This parameter specifies the length 
of the record to be output. 


STATUS! (output) This parameter soecifies the request status. 


condition identifiers: 
anetring validation _errors» 
ametSimproper_file_ ids 
amesimproper_access_ attempt» 
ameSimproper_ws!l_vatues 
ameStimproper_file positions 
ameSunrecovered write_error,» 
amesSfile organization conflicts 
ameSimproper _device_ciasss 
ametconflicting access levels» 
ame$record_exceeds mbl» 
anes$record_unequal_to_previous» 
ameSunsupported_ operation; 


procedure declaration: 


PROCEDURE CXREF] amp$reptiace_previous_record (file identifier: 
amt$file_identifier; 
working ustorage_areat “cell; 
working storage _length:3 amt$working storage_length; 
VAR status: ost$status)}3 
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22 PUSH (LISTEXT := ON) 77. 

*copyce AMTSFILE_IDENTIFIER 

*copyc AMTSWORKING_STORAGE_LENGTH 
*copye OSTSSTATUS 

*copyc AMCSCONDITION_CODE_LIMITS 
*copyc AMESCONFLICTING_ ACCESS_LEVEL 
*copyc AMESIMPROPER_FILE_I0 

kcoopye AMESPUT_LVALIDATION_LERRORS 
*copyc AMESTERMINAL VALIDATION ERRORS 
*copyc AMESRING VALIDATION ERRORS 
*copyce AHESIMPROPER WSL 

*copyc AMESPUT_PROGRAM_ACTIONS 

?? «POP 2? 


4e2 PROGRAM MANAGEMENT 


1. Loading files into multiple rings may cause improper ring 
attributes to be assigned. 
PSR NVOC739 


22 The toad tine for targe orogramns is too high. 
Solution: Pre-linked object aodules. 


Large programs take a tona timed to load. Analysis shows the 
foader spending much of its tine building addresses in static data 
sections. This is especially true in large FORTRAN programs. 


A process of "Pra-linking™ has been created to completely 
eliminate the time scent in the foader building static addresses. 
A bound program and its destination ring brackets are given to the 
virtual environment tinker {LINVE) which pre-links the product 
using a set of reserved segment nunbers. Ali addresses in static 
data sections are built and stored with the static data for the 
section. This data can be simply copied at toad time into its 
reserved segment. 


The output of the linker ts a singte object module which can be 
placed on an object tfbdbrary and/or executed. The Object Code 
Utilities handie this new nodule as it would any other object 
modulee Ati QCU commands may be used with a “pre-linked™ module. 


Examole 
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/link virtual_environment 

VEL/set_link options mode=PRQODUCT . 
VEL/add_obdject_file fFile=B30UND_ PRODUCT ring _brackets=(11lsi1lsi1) 
VEL/generate_virtual memory virtual _image=PRE_LLINKED PRODUCT 
eee 


ares ob ject_library 

COL/add_ module tibrary=PRE_LINKED_ PRODUCT 
COL/generate_library Jlibrary=PROQDUCT_LLIBRARY 
COL/ quit 

/ 


fexecute_task sp=PRODUCT_LENTRY_POINT fite=PRE_LINKED_PRODUCT 
f/execute_task sp=PRODUCT_ENTRY_POINT library#PRODUCT_LIBRARY 
/ 


Notes.and Cautions 


Care must be used when building programs that are made up of 
multiple "“pre—ltinked” modules. Ali pre-defined segment numbers 
must be unique for the entire load sequencee The STARTING SEGMENT 
parameter on the tinker command SET_LINK_OPTIONS can be used to 
specify the first reserved sagment number for a module. This 
parameter allows modufes that have been “"pre-linked™ separately to 
be used together at execution time. By defaults, the first 
reserved segment number is currently 36. 


The operating system reserves segments 36 to 63 for "pre-linked™ 
products. Each product must fit into these segments. Linker 
directives can be used to collect sections with similar attributes 
into one segment to reduce the total number of segments. 


With the current implementations sporatic initialization of 
read/write data will increase both file space and toad time. 
During the coding and binding of a programs efforts should be made 
to collect all initialized data together near the beginning of a 
segment. 


A warning diagnostic is issued if the linker finds a text imbedded 
library that has not been specified on a USE_OBJECTULIBRARY 
command. This warning car de ignored and the foader will attempt 
to satisfy them at toad tine. 


A map is generated by the tinker containing diagnostics and 
information on how the program was "pre-linked"™, The default file 
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name for the link map is $S$LOCAL.LINKMAP. 


With the current implenentations only one module should be 
"ore~linked”™, A program should be bound into a single module and 
then "pre-linked"™, 


conclusions 


The process of "pre-linking” vorograms can significantly reduce the 
time spent toading products. "Pre-linking™ one of the system 
products resulted in a 35-49 percent reduction in page faults» CP 
times, and elapsed time during loading. The reduction should be 
even greater when loading larga FORTRAN oroducts. 


403 PHYSICAL 170 _(TAPE) 


1. 


Tape usage is restricted to permanent file backup/restore and dump 
analyzer operations for R1.1.2. 


404 QASIC ACCESS METHOD 


le 


2s 


36 


The SET_LWORKING_CATALOG (SETWC) command has no effect upon files 
whose names are created within anolications. For example: 


execute task 
task generates file nane a 


Files created by programs are not subject to the working catalog. 
The program should specify a complete path name. Files referenced 
as parameters of commands (iee.» Files specified at command level) 
will end up using working catalogs. 

PSR NVEAOQ27 


Although the preset_vaiue file attribute can he set bye the 
set_file attribute commands this feature tis not supported. New 
pages assigned to segment access files are always initialized to 
zeros 

PSR NVOBZ04 


File attribute MIN_-RECORD_LENGTH fs not set properly for 
record otype F files. MINLRECORD_LENGTH should default to 
MAX_LRECORD LENGTH if it is allowed to defaults but it is currently 
defaulting to 0. This affects SORT/MERGE when the sort key is 


4-18 


SOFTWARE RELEASE BULLETIN 


NOS/VE Rlele2 LEVEL 630 


85/03/29 


420 OPERATING SYSTEM NOTES AND CAUTIONS 
4o4 BASIC ACCESS METHOD 


4. 
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7 


Be 


9. 


10. 


li. 


omitted and the default is takens The user should explicitiy set 
min_record length = max _record_length, 
PSR NVOD398 


Skipping forward/backward by records and partitions does not 
always report the encounter of boundary conditions with the 
correct exception condition. 

PSR NVOD424 


If a FAP returns abnormal status to AMPSOPEN during an UPEN (new)s 
then BAM still creates the tocal file.» In simpler terns» a user 
who makes amistake in the initial OPEN of an indexed sequential. 
fiie will receive a prover diagnostics but BAM wrongly goes ahead 
and creates the focal file anyway. 

PSR NVOEL150 


File attributes that can h® changed cannot be reassigned a NIL 
value. 
PSR NVEAGO3 


The SET_LFILE_ATTRISUTE conmand for an existing file accepts the 
specification of a preserved attribute even if it conflicts with 
the present one, No error «il! be seen and tha preserved 
attribute will not be changed. Use DISPLAY_FILE_ATTRISUTES to 
verify attributes were sete Alsos a subset of preserved 
attributes may be changed with the CHANGE_FILE_ATTRIBUTE command. 
PSRs NVOC3839s NVOD617» NVI0549» NV0D536 


COPY_FILE does not detect a coov of a file to itself via circular 
file connections. 
PSR NVEA118 


Files implicitly attached are not inplicitiy detached. 
PSRs NVOEB22»9 NVOE2Z96 


Attributes in the NOS/VE file tabel cannot be altered after 
creation. This could affect sone migrating applications using 
indexed sequential files because FILE_LIMIT couitd be updated on 
C170 but not on C180. 

PSR NVEAO34 


If a file has a file-access-procedure (FAP) associated with it» 
the file can not be accessed from within the job monitor task. If 
this is attempted» a message wil! report the inability to toad the 
FAP from the tibrary tist. To get around the problems enter a 
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utility environment of your choice and then access the file. AS 


an examples if you do a COPY FILE involving an indexed sequential 
file and the error "unable to load FAP .2.” occurs» then you have 
just experienced this probteme. 

PSR NVOC941 - 


le. [If a file was created by COLLECT _LTEXT at NOS/VE lelel» it was 
created with file content = legibte and tine number = (D» 06) 
(length and tocation). Under 1.1.29 if you attempt to copy this 
file to another file which does not yet exists the copy aborts 
with AM 160044 - fine number length and tocation are unequal. 
Note that it is impossible to create these files under 1.1.2 since 
(GO 98) are out of range values for tine number and the default is 
{1 1). 
PSR NVO0521 


4e5 LOADER 


1. The ftength of targe data segnents and files cannot exceed 
10020002500 bytes. 


406 INIERACILVE 


1. If an output tine for a disolay type terminal (CRT) Is exactly 
equal to the page width attributes overprinting of the fine will 
occur if more output lines follow. To remedy thiss set the page 
width differently or set the output device attribute (009) to 
printer. 


2e Users are now abie to inforn the OS of their terminal model by 
using SETTA's terminal model (TRM) parameter and specifying a 1-25 
character namee This attribute can oniy be changed by SETTA but 
can be retrieved by IFPSFETCH TERMINAL » 
IFPSGET_TERMINAL_ ATTRIBUTES» L[FPSGET_DEFLT_TERMINAL_ATTRIBUTES and 
can be displayed by DISTA. The Jogin defaults for this attribute 
are 'Codc721' for terminal class 35 "VT1I00" for terminal class 7» 
and the null name for afl other terminal classes. The 
restrictions which define valid SCL nmames are the only 
restrictions for specifying the terminal model parameter, 


3. A new error code has heen added to Interactive Facility's 
repetoire to indicate that a task has aborted a get overation 
becaus@# an interactive condition was received, 


IFESABORT_GET m=-ERROR=-- gat operation aborted because 
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interactive condition received 
4o7 PERMANENT FILE UTILITIES 


1. A new function S$BACKUP_LFILE is available under the 
restore permanent files utility. The purpose of this function is 
to interrogate the information on a backup _file produced by the 
backup_permanent_file utility. Ald characters returned in the 
string are in upper casee. The thackup_ file Function causes the 
backup file to be rewounds so only the first item on the backup 
File may be queried. 


SSACKUP_FILE( <file> <attribute>) 
The file parameter specifies the backup file to query. 


attribute result 


IDENTIFIER string Returns the vath name of the first item 
on the backup file. 
This is the defauit attribute. 
IDENTIFIER_TYPE 
string Returas the type of the item. Either: 
TSET* "CATALOG*® 'FILE® or # CYCLE? 
is returned. 


Currentiy no abbreviations are supported for either the function 
Or for the attribute keywords. 


An exampie use for this function is in attempting to restore from 
a backup file for which the nane of the catalog or file backed up 
is not knowns but the destination of the restore is knowne Note 
that the value returned is a strings so that $fname needs to be 
used to convert this to a file names if this is to be used as a 
parameter on the restore_cataltog or restore_file subcommands. 


Example: 

Suppose someone has sent you a backup tape produced by a single 
BACKUP_CATALOG commands and that you want to restore the catalog 

to your own catalog $USER.MY_CATALDG. You could do the following: 


restore_permanent_files !2!list file 
restore catalog SfnamelS$backuo file(backup_Filesidentifier)) e. 
bfzbackuo_file nen=Suser.ny_catalog 
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quit 


a= 
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5.0 PROOUCT_SET_NOTES AND CAUTIONS 


Jol CYBIL 


le 


46 


5 
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Be 


Je 


10. 


When using DEBUG to breakpoint on a nulti-line statements the line 
number supplied to DEBJG must be the Jlast tine number of the 
statement. 

PSR CILA498 


Run-time error messagess such as RANGE ERROR» do not display the 
bad value. 
PSR CILA575 


If binary maintenance is required» the CCM parameter must be 
Specified as S$SYSTEM.COMMIN.MAINTENANCE.OLD_UNBOUND_CCM. This CCH 
interface will be updated for Release 1.1.3. 


The largest negative integer value causes STRINGREP to abort with 
arithmetic overflow. 
PSR CILA338 


It is not possible to share data variables between CYBIL and 
another language {say FORTRAN)» because CYBIL does not have any 
mechanism to create a comnon block. 


Static initialization treats integers as 60 bits instead of 64 
bits. 
PSR CILA830 


The RUNTIME_CHECKS parameter is not accepted by the CYBIL 
compiler. Currentlys the CY3IL comoiler looks for RUNTIME CHECK 
(no '"S!'),. 

PSR CILOO0S 


Tag checking does not work. 
PSR CILA8S86 


Using a null string inside an inttne procedure gives a fength 
mismatch. 
PSR CILA969 


Using unimplemented features may cause CYBIL to abort with CG6i 
error 38. 
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40 


A deficiency in the COBOL/DE3US inplementation does not allow the 
MODULE and PROCEDURE parameter names to contain hyphens when 
specified by the user. This probien can be avoided by omitting 
hyphens in the PROGRAM-I)D name in the COBOL source programs or by 
relying on the default values for MODULE and PROCEDURE when using 
the DISPLAY PROGRAM_ VALUE» CHANGE_PROGRAM_VALUE and SETLUBREAK 
commandse (DISPLAY MEMORY does not support default MODULE names.) 
COBOL datalnames may contain hyphenss howevers when specified as 
the NAME parameter of the DISPLAY PROGRAM _VALUE and 
CHANGE PROGRAM _ VALUE commands. 

PSRs NVOFO43, DBBADS4S 


The KEY_TYPE attribute cannot be overridden any more. 
PSR CBBA431 


The utility routine CBPSSET_LFILE_ATTRIBUTES has been deleted. 
File attributes can be set in the COBOL program by doing ENTER 
NOLPSSCAN_COMMAND_LINE® using “"SETFA.eee"%» STATUS. The COBGL 
usage guide contains an exampie of the CLPSSCAN_COMMAND_ LINE 
routine. 


COBOL cannot reptace data items referenced by indices in the 
WINSPECT 222 REPLACE™ statement. 
PSR CB8A537 


When compiting with a working catatog sets and the compile file 
contains COPY statements» the reference decks are not expanded. 
PSR CBBOCHE 


53 ELLE MANAGEMENT UTILITY 


1. 


2 


Do not use the file name INPUT in batch modee It is always a null 
(empty) file with no data in it» Choose a different name, This 
affects migration of jobs from NOS» where the name INPUT was the 
job's input deck. Gn NOS/VE use the COLLECT_LTEXT command to 
create the input data. 


When using FMU and inside [Interstate Communication Facilitys do 
not do a CLEAR on the EXECUTE_LINTERSTATE COMMAND. This will clear 
the FASLAVE procedure file and render CREIC inoperable. 

PSR NVOF516 
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1. 


The ICF connection will be terninated without any indication 
(j.ee2 diagnostic or informational message) if an FMU job aborts 
within ICF. This occurs in batch jobs only. 

PSR NVOF320 . 


When using VAX migration commands (CREATE.VAX REQUEST» 


DISPLAY _VAX_REQUEST», DELETE_LVAX_REQUEST)» it is recommended that 


parameter specification be tlimited exclusively to keyword 
specification to aliow for the addition of new parameters in a 
subsequent release. 


ADVANCED ACCESS METHODS 


A job using an indexed seauantial file may fail due to entry point 
errors from the loader. 


The following command executed earlier in the job will correct 


this: 


SETLPROGRAM_LATTRIBSUTES TERMINATION _ERROR_ LEVELSFATAL 
or SETPA TEL=F 


PSR NVOEZ76 


When the FILE_LIMIT attribute is set too small for accommodating 
all updates or inserts» the user runs the risk of the access 
method aborting with an error AAESFILE_LATLFILE_LIMIT. In this 
cases the file is destroyed. . . 

PSR AA8A380 


All of the XREF decks relevant to indexed sequential file usage 
Should be in one base library. At presents some of them are in 
$SYSTEM-COMMON. PSFSEXTERNAL_INTERFACE SOURCE and some of them are 
in SSYSTEM.CYBILOSFSPRIGRAM_INTERFACE. 

PSR NVOF197 


The XREF deck AMPSGET_LKEY_DEFINITIONS forgets to copy in type 
declaration AMTSOPTIONAL_XEY_ATTRIBUTES. The workaround is to use 
ARRAY Clieen] of AMTSOPTIONAL_LKEY_ATTRISUTE. 

PSR NVOF938 


The GET routine does not honor S$KEY_LRELATION nor update the vatue 
in S$PRIMARY_KEY_ADDRESS,. 
PSRs AA8A377 
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COPY_KEYED_FILE aborts when cooying any empty file. 
PSR AABA357 


COPY_KEYED_FILE specifying output to a terminal causes the first 
character of each line to be lost, 
PSR AABAZ53 


COPY_KEYED_FILE aborts when copying a file containing a 
nonstandard collated key; the message is "CAN'T LOAD COLLATING 
TABLE". 

PSR AA8A338 


Je5 SOURCE CODE UTILITY 


1. 


36 


A CYBIL range error occurs at fine &747 of 
SCMSCONVERT_LUPDATE_TO_SCU.: 
PSR 5C8A130 


The workaround is to take out the LIST parameter. 


A new source tfibrary format has been implemented to support 
present and future perfornance Improvements. This will require 
conversion of existing tibraries with the command that follows: 


This command reads an SCU source tibrary in 1.0 format and writes 
it in 41.1 format. There is no procedure to convert 1.1 back to 
1.0. 


convert usculO_to_sculls CONS1OTO$11 ECoase=<filed] 
C[resuit=<file>] 
{status=<status_variabl!2>] 


base { b This is the name of a file containing an SCU 
source _ltibrary in the 1.9 tibrary format. If this parameter 
is omitted an attenot is made to access a file named 
SOURCE _LIBRARY. 


result ${ r 3: This is the name of the file to receive the converted 
library in version 1e1 format. If this parmeter is omitted 
the library wil! be written on file SOURCE _LIBRARY.$NEXT. 
status ! Status variable. 


With the new tJtibrary fornat the lists of featuress groups and 
modifications for a tibrary will be maintained tn alphabetic 
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Sequence. The list of modifications and groups associated with 
decks will be kept in the same order as previously used.» In 
connection with this change the disptay_option parameter has been 
changed on the display modification list commands 


display _modification_list Coutout=<file_ referenced] 
[display _options=alohabeticichronological] 
Cstatus=<status_variahbla>] 


output { o : This is the name of the file which receives the 
display. Default is $OUTPUT. 


display loptions i display loetion | do : If this parameter is given 
the keyword value CHRONOLOGICAL or C» modifications will be 
order by date and tine of modification with the least recent 
first. If this paraneter is omitted or vaiue ALPHABETIC or A 
the order will be alohabetic. 


status 3: Status variable, 


This command displays a fist of ali the modifications for a source 
fibrary. 


4%» The deck description parameter on the create_deck and change deck 
comamndss the library description parameter on the create_library 
and change _library comnands and the modification_description 
parameter on the create _modification and change_modification 
commands ali accept as their values a tist of strings. The 
corresponding $deck_ header » $library header and 
$modification_header functions have been modified to return an 
array of strings as the value for the description fields when it 
is appropriate. 


5°6 PRODUCT _SET_=_DE BUG 


l» When an unselected event occurs in a ring tower than the ring in 
which it is runnings DEBUG incorrectiy informs the user that the 
error occurred in the procedure which called the faulty procedure 
in the lower ring. 

PSR DB8AD98 


Ze DEBUG and CYBIL do not have a run-time interface. Therefores a 
program which aborts due to "CYB8IL run time error™ cannot be 
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properly trapped by DEBUG. Insteads the DEBUG trap occurs in the 
CYBIL error processor, To reference variables in the failing 
procedures MUDULE and PROCEDURE parameters need to be explicitly 
specified. Howevers, dynamic variables disappear as soon as the 
run-time error occurs. 


3e The operation of DEBUG in a multi-ring environment is not 
weli-defined. DEBUG only gets control when the program executes 
‘in the same ring as set by the SCL command Set_Debug_Ring. 


4%, DEBUG does not coordinate its prompting activities between two 
asynchronous tasks, 
PSR DBBAG76 


5» DEBUG does not accept *yohenated names for MODULE or PROCEDURE 
parameter values. COBOL users may use the default value for these 
parameters in fine mode OD€8UG. Full screen DEBUG users must 
remove the hyphen from the orogram id statement name and 
recompile. . 

PSR DBBAO54 


57 APL 


le AFIFIX is needed in order For the APL/YVE conversion utility to 
successfuliy convert "APL structured files” from APL2 format to 
APL/VE format. Installation of AFIFIX is discussed in Section 
321.2 of this SRB. 


APL2 structured files are NOS random files with a format that oniy 
APL2 understands.» If the user attempts to bring a random file 
over to NOS/VE using get_files the records get packed together» 
and as a result the randon file directory becomes meaningless» and 
can no Jonger be used to tocate the records. AFIFIX copies files 
to get rid of EQRs so that they can be brought across to NOS/VE 
without their random file directories becoming out of synch with 
the data.» So the user must apoly AFIFIX to all APL structured 
files gn the NOS sides before using the APL/VE conversion utility 
on theme To use AFIFIX»s enter: 


GETsAFIFIX/UN=APLO. 
and then either 
AFIFIXsLFNI. (to onty get the control byte 
sets which is why current 
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. APL2 users use AFIFIX). 
or AFIFIXsNOEORsLFNI. {to get the contro! byte set 
and to get the fille copied 
without EDRs so it can be 
brought over to APL/VE via 
the conversion utility). 


528 FILE MIGRATION ALD 


1. Do not use CLEAR? or FRETURNS*! fo clean. up NOS files. This will 
delete internal FMA files and cause FMA to fail. <Aisos executing 
an EXIT control card will cause FMA to fail. This item is a 
warning only and will atso apoear in the Migration Guide. 


5.9 SORT 


1. When a predefined key nanes @ege» COUBDL6s Is used for a user 
specified collating sequence names diagnostic message 610110 may 
show up twice to indicate the error though one error message is 
sufficient. | 
PSR SMBA105 


Ze If a nonexistent file is specified by the DIR parameter of 
SORT/MERGEs an empty file by that name will be created by the 
system. 


310 FORTRAN 


In order to allow comparisons of Holterith data stored in real 
variables» the code for 229. jand NE. relational expressions with 
real operands has been changed to do a biteby-bit comparison of the 
operands» rather than a floating point comparison. This change 
emphasizes the need to maintain all real values as standard normalized 
floating point numbers or zero in order to ensure correct 
compulations.e The compiler autonaticaily normalizes ail real 
constants and the results of al! Floating point operations with 
normalized operands will be normalized» but nonstandard or 
unnormalized values can be introduced by means of boolean expressions, 
equivalencing to other data types or various input operations. 


5211 LIS? 
le. At this release, LISP/VE is a partial implementation of Common 


Lispe The functions implemented for Rlele2 were chosen to provide 
the user an adequate aorking base =for common programming 
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appiications. The fist of functions currently supported is 
available in the LISP/VE Language Definition Usage Supplements 
publication number 60486213. 


Performance will not be ootinal until the compiler is available at 
a jater release. In particulars the print functions when 
implemented with the full capabilities was Slows LISP/VE 
therefore provides a faster (but tess capable) version of the 
print functions named “print™s and the complete version has been 
named "silow~print®*. Patience is important until the compiler is 
complete. | 


When the system editor is called from within LISP/VE» the editor 
parameter [sCOMMAND must be used. For example: 
(VE-COMMAND "EDIF MYFILE IT=COMMAND"), 


NCONC causes LISP to hang If oassed a circular LIST. User break 
can be used to terminate LIS? when this happens. 


When a file F contains an unnatched vertical bars for examples 


(setq a ix)ds loading that file causes LISP to hang. 


LISP aborts if it runs out of available space. This happens 
because NOS/Ve aborts LIS? instead of giving it control when a 
segment overflows. 


NOS/VE witli hang when it is given a tine of more than 2000 or so 
Characters. To exit when this occurs one must disconnect” the 
terminal sessions sign back ons and execute a terminate_job NOS/VE 
command to kill the job. The disolaying of the stack sometimes 
causes this to happen. 


2012 DBJECT CODE UTILITY 


1. 


A new version (V1.1) of object code tibrary format has been 
implemented to support imoroved message template capabilities. 
Message template modules are now created through the OCU 
CREATE_MESSAGE MODULE subcommand which places message template 
modules on the object tibrary. The OCU on the R1e1le2 system can 
accept object modules fron both ofd (V1.0) and new (V1.1) 
tiovraries but will only generate new (V1.1) format librartes. 
Libraries created by the 81.1.2 9CU cannot be used by previous 
versions of the system or previous versions of 3CUe. Obdject 
modules (but not SCL procedures or program descriptions) can be 
moved from a Viel library to a V1.0 !tibrary as follows: 
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ae Using the V1.1 CREDL» do the Following: 


CREOL 
-ADDM vil_library “version V1.1 tibrary* 
GENL object file f=f "ganerates an object file" 


be. Using the V1.0 CREDL» do the following: 
CREOL 


ADOM object file "generated as above" 
GENL vlO_library “version V1.9 object tibrary" 


Sel3 MESSAGE TEMPLATES 


ls 


Previous versions of message temolate modules cannot be used by 
the R1.1.2 systems. They must be rebuilt using the 
SENERATE MESSAGE _TEMPLATE MODULE procedure. A MODULE statement 
must be placed at the beginning and a MODEND statement at the end 
of the message template definitions in order to provide the name 
for the message template nodule on the OCU library. The message 
template module should be placed on the same tibrary as the 
Program description and CY3IL modules for the application program. 


3014 PROGRAM INTERFACE 


1. 


Changes to the program interface require the recompilation of ali 


CY8IL modules. Modules which have not been recompiled may 
encounter 'decitaration mismatch! errors when they are loaded. In 


additions any modules bound with runtime libraries will have to be 
rebound. 
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6.0 HOST SYSTEM NOTES 


620 HoT a YSTEM_ NOTES 


Gel NOS 822401 


1. 


The BATCHIO printer driver does not correctiy nandie long tines 
(over 135 characters). The extra characters are either droppeds 
averprinteds or cause the page to be spaced erratically. 

PSR NS2C121 


Ge2 NOQI/3E_Lo27_ GPERATING SYSTEM 


1. 


3° 


The NOS/BE terminal driver always issues a fine feed (LF) in 
response to a carriage return (CR) sent from a terminal. This 
causes a problem when using the NOS/VE Full Screen Editor {FS$é) 
with terminals which considar the home position (command tine) to 
be the last tine of the display and do not have a page mode. For 
terminals like thiss such as the CDC 722-10» the user should clear 
the screen (followed by a CR) to cause the NOS/VE FSE to repaint 
the entire screen. 


NOS/VE fails to deadstart after a NOS/BE checkpoint/recovery 
deadstart due to checkpoint flags set in the Environment Interface 
face Communication Block. 


Solution: 


NVE subsystem control ooint hangs after ae tftevel 3 recovery 


deadstart due to coding error in LAB. 
Solution: 
Install NBOE481 from SOLVER. 


The DST1 job on the installation decks PL will not install NOS/VE 
binaries correcttiy. 


Sofutions: 
Instali the following modification to the installation decks: 


=IDENT C7535DST 
=B HISTOR Y.2 
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C7535DST CORRECT VE ROUTINE EDITLIB. 


JWB 03/15/85 DST1 
=C HISTORY 
=D C7535DK.7 NEAR DST1.315 
REPLACE CFASLAVE »NUC sAL=19FL=231900) 


REPLACE (DSMRUN»sNVecsAL=19 FL =44096) 
=) C7535DK.21931 
SETAL(CLOSLNK»s 90) 
SETAL(GETLNK»s GO) 
SETAL(GETNLNK»s90) 
SETAL(GETPLNK»s 0) 
SETAL(MLIF »0) 
SETAL COPENLNK»s 0) 
SETAL (PUTLNK»s 0) 
SETAL(PUTNLNK»9) 
SETAL(PUTPLNK»s0) 
SETAL(WREPLNK» 0) 
SETALCIC7MMLI90) 
=C OST 
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720 FCA LEVELS 


700 ECA_LEVELS 


NOS/VE Vi.e1l.2 level 630 was tested In an environment containing the 
following hardware and software conponants. 


COMPONENT RELEASE LEVEL 
7155/7855 (FMD) MA721-A10 
TO2ZL/67X (CFIRMHOX) MB434-A14 

CYBER Initialization Package CIPQ03 

NOS V2e4%e1 Level 6396 
CML Level 170 


NOS/Be V1.5 level 627 


The following components are certified at the indicated levels: 


MODEL FCA Index # CIP CML NOS NOS/VE NOS/B8E 
CYBER 3610 T8D 063 170 V2.40.1 1630 V1l.i.2 1630 V1.5 1627 
CYBER 815 T8D 003 170 V2.%.1 1630 V1l.1.-2 1630 V1.5 L627 
CYBER 825 T8D 0039 179 V2.4.1 1630 V1.1.2 1630 Vi.5 L627 
CYBER 8390 TBD 003 170 V2e4el 1630 Viele2 L630 V1.5 L627 
CYBER 835 TBD 003 179 V2.4%5-.1 L630 VieleZ@ £630 V1.5 L627 
CYBER 840 TBD 003 170 V2e%.1 L630 Vi.ei.2 1630 V1.5 L627 
CYBER 845 TBD 003 170 V2.e4el 1630 V1lele2 1630 Vie5 Lb&27 
CYBER 850 TBD 603 170 V2.4~5.1 1630 V1e1e2 L630 V1.5 L627 
CYBER 3855 TBD 003 170 V2e4%el L630 V1ei.2 L630 V1.5 L627 


CYBER 869 TBD 603 170 V2.4-e1 1630 V1.1.2 L630 V1.5 L627 
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8.0 FUTURES 


8.0 EUTURES 


This section is to communicate sone future customer impacts eaxpected in 
and prior to NOS/VE Ri~le2e» allowing the customer to be better prepared 
at the time of that release. 


8.1 NOS/VE RELEASE _Lela2 QUAL_STATE COMBINATIONS 
NOS/VE Rlele2 will be certified with NOS 2e4.1 as its dual state 
partner. Based on Control Data's software support policys NOS/VE R1.1.2 
will also be supported in critical ®38.mode_only with the dual state 
partner NOS Release 203 Level 617.6: 
Be2 ROUTE. PARAMETER CHANGE 
IRHF allows a user on NOS to route a NOS/VE batch job as follows: 
ROUTEsfilenamesDC=LPsFC=RH 
or 
ROUTEsfilenamesDC=INsST=NVE. 


For NOS/VE R1.e1.-35 the capability to use the first route (route to 
output queue) will be removed, 


8.3 $cu 


At NOS/VE R1l.1.35 the INFORMATION_LEVEL,» IL» parameter of all Stu 
commands witl be changed to DISPLAY_IPTIONs DO. 
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AlsO SAMPLE PROCEQURES FOR DISPLAYING FAILURE_DATA 


The following SCL procedures are provided as an example of how to use 
DISPLAY_BINARY_LOG to obtain failure data. It is necessary to include 
Ssystemeosftsite_command_tibrary in the user's command tist to use 
DISPLAY_BINARY_LOG. 


Alsi DISPLAY_D1SK_FALLURE DATA 


PROC display _disk failure _data sdisdfd ( oe» 
fogs: file =S$local.$engineering_log3 o» 
outputso? file = $output) 
display_binary_log is%value(log) o=tvalue(output) 
define group system_action statistic=C€4350000 
define group software_failure statistic=C4350601 
define _group $7155_failure statistic=#24350003 
dump group group=system_action cf=(015.498)9(5.27910)) 
dump.group group=software_ failure cf=((1..498)5(50.28310)) 
dump_group group=$7155_ failure o's 
CREe( (1.0498) 9 (5021091 SC) eo {11.1693 )9117910)9(18..6098)) 
quit 


PROCEND display disk failure data 
Al.1.1 DISPLAY TAPE_FAILURE_ DATA 


PROC display_tape_faiiure_data »sdistfd ( eo. 
flogsl: file =Slocal.tengineesring_1og3 o- 
outputeo? file = $output) 


display _binary_tog i=tvalue(log) o=Svaiueloutput) 
define_groue group=$7021_failure statistic=€M351002 
dump_ugroup group2$7021l_failure eo» 
cf=( (102498) 9b. oFalLOda (LO 259 8d vee? 
(262228910) >» (29916)59(030910)9(31..26298)) 
quit 


PROCEND display _tape_failure_data 
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A200 RECONELGURATION 


AZ+1 ASSUMPTIONS 


1. 


eo 


The reader is already familiar with the NOS/VE installation and 
deadstart process but is not familiar with what to do in 
particular failure situations. 

The system analyst wild look at the NOS/VE operator console (for 
failure information in the event of a system failure. If the 
system has not failed but peripheral failures are suspected» the 
System analyst will took at the Engineering tog for failure 
information. 

The site has generated a deadstart tape with the specified 
physical and togicai configurations as depicted below. Unless 
otherwise specified» assume the site has installed NOS/VEs has 
been running the systens Aas permanent files on disk and has 
backup tapes of the permanent Files. 


A2e2 CALLURES NOT REQUIRING RECONELSURATION 


4s 


5s 


If the performance of the system is degrading and there is an MDD 
consoles see if unrecovered disk failure(s) have been reported. 
Alternativelys, use the DIS?LAY_BSINARY_LGG command to determine 
whether unrecovered disk/tape failures have been reported in the 
Engineering Log. 

The first alternative to consider when ao peripheral failure is 
suspected is to terminate NOS/VE (CEFF still running) and revert to 
NOS (singte-state execution). When NOS/VE is terminateds ai! 
devices remain DOWN in the NOS configuration. Therefore MALET may 
be used on NOS to isolate and repair peripheral hardware problems. 
If the problem is a hafdware ftogic faiiure and is repaireds one 
Should be able to perform a continuation deadstart and resume 
normal operation. If this alternative is not chosen and the 
failing element is the systen deadstart controttier or disk drive,» 
any modified data in NOS/VE real memory at the time of the failure 
will be lost. 

If repair will take too jong or files will be fost as a result of 
the failures the discussion below Is pertinent. 
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A2.3 CONFIGURATION #1 ~ SINGLE CONTROLLER 


A2+3 CONELGURAIION_#1.= SINGLE CONTROLLER 


Nete that the disk and tape units are only accessible fron one 
controlter. This is not a recommended configuration from the 
standpoints of fault tolerance and system performance. Compare the 
following scenarios with those of configuraton #2. 


channel © channel 2 channel 6 
a 3 : 
3 s ; | 
; H H 
disk disk tape 
controller controller controller 
a 3 4a 
4 3 8 
; H . H 
unit Oe---=- (system) unit 3-<-<1 uni t4o--% 
3 2 
3 2 
unit Lle--} unit 4--—{ 


A2Ze3e1 DISK RECONFIGURATION SCENARTOS 


Listed below are scenarios for nossible disk failures which require a 
NOS/VE deadstart or which occur while deadstarting NOS/VE. Assume that 
in each case the desired recovery action Is to change the configuration 
and resume operations as soon as possibie. In the discussion below a 
"bad HDA' refers to the disk pack nounted on a disk drive; failures such 
as head-crash or a bad head may cause data to be recorded improperly or 
to be incapable of being read. 


1. Assume 1) a bad HDA on disk #1 (not system device) or 2) a failure 
in disk drive #1 which will take too tong to repair and no spare 
disk drive. The desired result is to delete disk #1 and continue 
degraded operation with only i disk (#0) on channel #0. 


ae Rebuild the NOS/VE deadstart tape with a new configuration 
prolog. The new protog shoutd have the failing device in 
the physical configuration but not in the jogical 


configurations ioe the INSTALL LOGICAL CONFIGURATION 
subcommand of the LIGICAL_CONFIGURATION_UTILITY (LCU) should 
Texciude' the Failing element. In addition the 


configuration prolog may need to be changed if it was set up 
to INITLIALIZE_MS_VOLUME and ADD _VOLUME_TO_SET for the 
failing element; these subcommands must be deleted, 

be Perform an tinstallation deadstart! of NOS/VE. 

Ce Reload permanent files. Since you now have aniy 3 disks» 
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de 
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he 
i. 


22 Assume 


you may need to reload files for a subset of the users and 
tell the rest of your users to walt for the fourth disk to 
be repaired. 

Resume operation in a degraded mode, 

When the failing disk nas been repaireds execute the LCU to 
re-install the togical configuration to ‘tinctude' the 
repaired element. Note that the newly installed tfogical 
configuration will not become active until the next 
continuation deadstart.: : 

When convenient do a TER MINATE_SYSTEM and then a 
continuation deadstart,. This will activate the logical 
configuration instalied above. 

Execute the LOU to INITIALIZE_MS_ VOLUME and 
ADDL VOLUME_TOLSET for the repaired element. 

Reload any permanent files not previousiy reloaded. 

Continue with normal systen operation. 


1) a bad HDA on disk #9 (system device) or 2) a failure in 


disk drive #0 which will take too tong to repair and no spare disk 


drive. 


The desired result is to detete disk #0 and continue 


degraded operation with only 1 disk (#1) on channel #0. 


ae 


Ds 
Ce 


d. 


Be 


Rebuiid the NOS/VE deadstart tape on the NOS system. The 
SET_LDEADSTART_DEVICE- system-core command must be changed to 
reflect the type of unit and the unit—number (1) for the new 
system disk» The configuration proiog must also be rebuilt. 
The new prolog should have the failing device (0) in the 
physical configuration but not in the logical configuration, 
jee. the INSTALL_LLIGICAL_CONFIGURATION subcommand of the 
LCU should texctude' the Failing element. In addition the 
configuration prolog may need to be changed if it was set up 
to INITIALIZE_MS_VILUME and ADD _VOLUME_TO_SET for the new 
system device; these subcommands must be deleted, 

Perform an 'installation deadstart® of NOS/VE. 

Reload permanent files. Since you now have only 3 disks» 
you may need to reload fites for a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
be repaired. 

When the failing disk has been repaireds execute the LCU to 
re-instail the fogical configuration to tinciude!? the 
repaired element. Note that the newly installed logical 
configuration will not become active until the next 
continuation deadstart. 

When convenient do a TERMINATE_SYSTEM and then a 
continuation deadstart.: This will activate the togical 
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configuration installed above, 

Execute the LeU to INTITIALIZE_ MS. VOLUME and 
ADD _VOLUME_TO_SET for the repaired element. 

Reload any permanent files not previously reloaded. 

Continue with normal system operations 


3e Assume 1) a bad HDA on disk #3 (not system device) or 2) a failure 
in disk drive #3 which will take too long to repair and no spare 


disk 


drive. The desired result is to delete disk #3 and continue 


degraded operation with onfty 1 disk (#4) on channel #2. 


ae 


be 
Ce 
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4. Assume 


Rebuiid the NOS/VE deadstart tape on the NOS system. The 
configuration proloa will need to be changed. The new 
projiog shouvid hprave the failing device In the physical 
configuration but not in the fogical configurations i.e. 
the INSTALL_LOGICAL CONFIGURATION subcommand of the 
LOGICAL CONFIGURATIION_UTILITY {€LCU) should ‘exclude't the 
Failing element. In addition the initiatization prolog may 
need to be changed If it was set up to INITIALIZE_MS_ VOLUME 
and ADD_VOLUME_TO_LSET for the failing device} these 
Subcommands must be deteted,.: 

Perform an "installation deadstart? of NOS/VE 

Reload permanent files. Since you now have only 3 disks» 
you may need to reload files For a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
be repaired. 

When the failing disk has been repaireds execute the LcU to 
‘include! the failing element in the installed ltogical 
configuration. Note that the newly installed fogical 
configuration will) not become active until the next 
continuation deadstart. 

When convenient = do a TERMINATE_SYSTEM and then a 
continuation deadstart. This will activate the logical 
configuration installed above. 

Execute the LOU to INITIALIZE_MS_ VOLUME and 
ADD_VOLUME_TO_SET for the repaired element. — 

Reload any permanent files not previously reloaded, 

Continue with normal systen operation. 


the controller on channel #0 requires repair and that the 


repair wii! take too long.’ The desired resuit is to delete the 
failing controlier from the configuration and continue degraded 
operation with the singie controltier on channel #2. 


ae 


Have a Customer Engineer recabte units 0 and 1 to the 
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controller on channel 2. . 

Rebuild the NOS/VE deadstart tape on the NOS system. <A new 
configuration prolog is required. The new protog should 
show units 6 and 1 being connected to the controtler on 
channei 22 The configuration proiog should aiso be changed 
to ‘fexciude’' channel oOo from the installed logical 
configuration. The SET_LDEADSTART_CONTROLLER system-core 
command may need to he changed if the controller on channel. 
#2 has ai different product_identification than the one on 
channel #6. 

Do a SETVE to change the deadstart channel number from 0 to 
2s . 

Perform an tinstatiation deadstart! of NOS/VE. 

Reload permanent files. 

Continue degraded system operation. 

When the failing controller has been repaireds use the 
INSTALL _ PHYSICAL CONFIGURATION subcommand of the 
PHYSICAL_CONFIGURATLON_UTILITY to re-install the original 
physical configuration. Note that the newly installed 
physical configuration will not become active until the next 
continuation deadstart.’ 

When convenient do a TERMINATE_SYSTEM. Recabling cannot 
occur while the NOS/VE system is executing. 

Recabie to match the installed physical configuration. 
Perform a continuation deadstart. 

Continue with normal system ooeration. 


5. Assume the controller on channel #2 requires repair and the repair 


will 


take too longe. The desired result is to delete the failing 


controller from the configuration and continue with the remaining 
controller on channel #0. 


ae 


De 
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ds 
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Have a Customer Engineer recable units 3 and & to the 
controller on channel #0. 

Rebuild the NOS/VE deadstart tape on the NGS system. A new 
configuration prolog is required. The new profog should 
show units 3 and 4 betng connected to the controller on 
channel #0. The configuration prolog should also be changed 
to *exclude! channel. 2 From the instalied logical 
configuration. 

Perform an ‘installation deadstart* of NOS/VE. 

Reload permanent files. 

Continue degraded systen operation. 

When the failing controtter has heen repaireds use the 
INSTALL PHYSICAL CONFIGURATION subcommand of the 
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PHYSICAL _CONFIGURATION_UTILITY to re-install the originat 
Physical configuration. Note that the newly installed 
physical configuration does not become active until the next 
continuation deadstart.’ 

ge When convenient do a TERMINATELSYSTEM. Recabling cannot 
occur while the NOS/VE system is executing. 

he Recable to match the instalied physical configuration. 

i. Perform a continuation deadstart. This wilt activate the 
physical configuration installed above. 

Je Continue with normal: system operation. 


6» Assume 1) the HDA on disk #1 (not system device) is not damaged 


7 


and 2) the failure in dis«x: drive #1 will take too long to repair 
and 3) a spare disk drive. The desired resuit is to delete the 
failing devices to move the disk pack from the failing drive to 
the spare drives and to continue normal operation. 


a» This assumes that a spare disk drive has heen physically 
configured and that the disk pack (HDA) normally mounted = on 
the drive is not currently used by NOS/VE»s i.e. the disk 
drive is defined in the installed physical configuration out 
not in the instalied togical configuration. lf these 
assumptions are not valid» then follow one of the earlier 
scenarios concerning a failing disk drive. 

be Remove the disk pack: (HDA) from drive #1 and mount it on the 
spare drive. 

ce Perform a continuation deadstart and request operator 
intervention. 

ds» From within the LCU use the INSTALL LOGICAL CONFIGURATION 
subcommand to 'exciude' drive #1 and tinctudet the spare 
drive. 

@. Continue normal system onveration. 


Assume 1) the HBA on disk 80 (system device) is not damaged and 2) 
the failure is in disk driv2 #90 which will take too tong to repair 
and 3) a spare disk drive. The desired result is to detete the 
failing devices to move the disk pack {HDA) from the failing 
device to the spare device and to continue normal operatione Note 
that B835-ix (FMD) HDAs can be removed by a CE and moved to a spare 
drive. Operators can move 344-4x drives themselves. 


ae This assumes that a spare disk drive has been physically 
configured and that the HDA normaliy mounted on the storage 
device is not currentiy used by NOS/VEs ieee the disk drive 
is defined in the instalfed physical configuration obut not 
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assumptions are not valids then follow one of the earlier 
scenarios concerning a falling disk storage element. 

be Remove the disk pack (HDA) from drive #6 and mount the pack 
on the spare drive. 

ce If the disk pack was moved to channel #2 use the SETVE 

_ command to change the deadstart channel from 0 to 2. 

de Perform a continuation deadstart and request operator 
intervention. 

ee If necessary change the SET_LDEADSTART_CONTROLLER system-core 
command to specify the oroduct-identification of the 
controltler. 

f. Change the SET_DEADSTART_DEVICE system-core command to 
identify the unit number of the spare drive. 

g. From within the LCU use the INSTALL LOGICAL CONFIGURATION 
Ssubcommand to fexcludef drive #6 and tinclude! the spare 
drive, 

hs» Continue normal system oneration,s 


A2.302 TAPE RECONFIGURATION SCENARTOS 


Listed below are scenarios for possidie hardware failures which may 
occur {or be detected) while using tave peripherals as configured in 
configuration #1. 


1. Assume a faiiure in the tape controller has caused a NOS/VE 
interruption. The desired result is to remove the failing tape 
controtier from the NOS/VE configuration to allow diagnosis and 
repair to occur in the NOS state concurrent with NOS/VE execution. 


a» Perform a continuation deadstart and request operator 
intervention. 

be From within the LCUs re-install the togical configuration 
and exclude’ channel 4. 

ce Continue operation without the tape controller. 

de When the tape controller has been repaireds execute the LCU 
to re-install the tJogical configuration and 'tincludet 
channel #6. Note that the newly instatied logical 
configuration wil! not become active until the next 
continuation deadstart.: 

ee When convenient do aéiéTERMINATELSYSTEM and perform a 
continuation deadstart to activate the newly iInstatied 
logical configuration. 

fs» Continue with normal operation. 
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2e Assume a failure in the tape controller which does not cause a 
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ae 


NOS/VE Interruption. The desired result Is to remove the failing 
controller from the NOS/VE configuration to allow diagnosis and 
repair of the element to occur In the NOS state concurrent with 
NOS/VE execution. 


ae Execute the LCU to re-install the togical configuration and 
fexciude’ channel #6. Note that the newly instalied togical 
configuration does not become effective until the next 
continuation deadstart. 

be When convenient do a TERMINATE_SYSTEM and perform a 
continuation deadstart.’ 

Ge Continue operation without the tape controller. 

de When the tape controller has been repafireds repeat the 
process above to finctude’ channel #6. 


Assume that tape unit #40 has failed. Aliso assume that this 
failure has not caused a NOS/VE interruption. The desired result 
is to replace unit #409 with a different tape unit from the NOS 
configurations use the NOS state for diagnosis and repair of the 
failing element and continue NOS/VE execution, 


ae Use the PCU to ra-install the physical configuration 
omitting the falling tape unit and adding the replacement 
tape unite . Note that the newly instailed physical 
configuration will not become active untii the next 
continuation deadstart. 

be» Use the LCU to re-install! the fogicali configuration. Note 
this is necessary because the iLCU captures some of the 
information in the installed physical configuration which 
changed above. 

ce When convenient do a TERMINATE SYSTEM and ai cantinuation 
deadstart. 

de Continue with normal systen operation. 


Assume that tape unit #40 has failed and the failure caused a 
NOS/VE interruption. The desired result is to replace unit #40 
with a different tape unit fron the NOS configurations use the NOS 
state for diagnosis and repair of the failing element and continue 
NOS/VE execution. 


ae Perform a continuation deadstart. 

be After deadstart run the PCU to install a new physical 
configuration which onits the failing tape unit and defines 
the replacement. 
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ce» Do a TERMINATE_SYSTEM and nperform another continuation 
deadstart to activate the newly instaltied physical 
configuration. 

de Continue normal system overation. 
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A2e4 CONFIGURATION #2 —- MULTIPLE CONTROLLERS 
channel 90 channel 1 
vise disk 
controller controller 
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Listed below are senarios for oossible hardware failures that may 
require a NOS/VE deadstart or may occur while performing a NOS/VE 
deadstart. The following scenarios can also be apptied to the case 
where the failure did not cause a NOS/VE tEnterruption. In this case one 
can execute the LCU to ‘exclude’ aie failing controilers do a 
TERMINATE SYSTEM when convenient and then follow the steps below 
omitting the operator intervention and consequent LCU execution. 


A2e%el DISK RECONFIGURATION SCENARIOS 


The following describes the recommended approach for dealing with the 
failure of one of the two disk controllers in configuration #2 above. 


le Assume the site has configured to channel #0 unit #0 for the 

deadstart device and the controller on channel #C fails. The 

desired result is to return the controtler to the NOS state for 

diagnosis and repair and to continue degraded operation minus the 
Failing controller. 

ae Execute SETVE command to change the deadstart channel number 
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from 0 to l. 

Perform a continuation deadstart and request operator 
intervention. . | 
Change the SET_DEADSTART_CONTROLLER system-core command If 
the product_identification of the controtier on channel #1 
is different than that of the controller on channel #¢C. 

From within the LCU use the INSTALL_LOGICAL_CONFIGURATION 
subcommand to ‘fexclud2! channel #0. 

Continue degraded system oneration. 

When the failing controller has been repaireds use the LCU 
to re-instali the Jogical configuration and ‘finclude! 
channel #0. Note that the newly installed logical 


configuration will. not become active until the next 


continuation deadstart,. 

When convenient do a TERMINATE_LSYSTEM and perform a 
continuation deadstart ts activate the newly installed 
logical configuration. 

Continue normai system operation. 


22 Assume the controller on channel #1 fails. The desired result is 
to return the failing controller to the NOS configuration for 
diagnosis and repair and to continue with degraded system 
operation minus the failing controller. 


Ae 


A2e4e2 TAPE 


Perform a continuation deadstart and ask for operator 
intervention. 

From within the LCU use the INSTALL _LOGICAL_CONFIGURATION 
subcommand to fexclude’ channel #1. 

Continue degraded system oneration. 

When the failing controlter has been repaireds use the LCU 
to re-install the logical configuration and ‘include’ 
channel #1. Note that the newly instalied togical 
configuration will not become active until the next 
continuation deadstart. 

When convenient do a TERMINATE_SYSTEM and perform a 
continuation deadstart to activate the newly Installed 
logical configuration. 


RECONFIGURATION SCENARIOS 


The following is the recommended approach for dealing with the failure 
of one of two tape controllers in configuration #2 above. 


1. Assume one of the controllers on aither channel #2 or channel #3 


fails. 


The desired result is to return the failing tape 
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controlier to the NOS state for diagnosis and repair and to 
continue degraded operation ninus the failing controller. 


ae Perform a continuation deadstart. and ask for operator 


De 


Ce 


de 


intervention. 

From within the LCU use the INSTALL_LOGICAL_ CONFIGURATION 
subcommand to ‘exclude!’ the channel with the failing 
controller. 

When the failing controller has been repaireds use the LCU 
to re-install the togical configuration and tincludet the 
channel with the failing controller. Note that the newly 
instaited logical configuration will not become active until 
the next continuation deadstart. 

When convenient do ae TERMINATE_SYSTEM and perform a 
continuation deadstart to activate the newly installed 
logical configuration. 
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B1.0 PERIPHERAL MAINTENANCE. PROCEDURES 


Bl.l INTRQDUCTION 


Failure data for peripheral devices dedicated to NOS/VE are emitted as 
statistics to $ENGINEERING_LOS in binary format {Section Al-1). The 
Statistics facility command DISPLAY_BINARY_LOG provides a mechanism for 
monitoring those errors encountered during system operatione While this 
facility can be used by anyone via SCL commandss the format of the 
output does not describe the status fieids in sufficient detaii to 
permit easy interpretation. Three independently executable SCL 
procedures are provided that oroduce several reports by editing the 
output of DISPLAY_BINARY_LOG. These procedures are included in tibrary 
SSYSTEM.*OGSFSSITE_ COMMAND LISRARY, A certain amount of execution time 
overhead is incurred as a result of using SCL to do the editings but the 
command structure is easily modified to include new statistics that may 

be added in subsequent releases, 


B1l.2 USAGE 


These procedures are initiated interactively by the commands 
DISPLAY_HPA_SUMMARY (DISHS)» DISPLAY_HPA_DISK DETAIL {(DISHDD)»s and 
DISPLAY_LHPALTAPE_DETAIL (DISHTD). Ther2@ are no required parameters, 
Default output is S0UTPUT. Default input is the current system 
$ENGINEERING LOG. Alternative files nany be specified by the following 
parameters: 


inputs i 3: file 
output, o : file 


These procedures should be initiated immediately prior to terminating 
SENGINEERING_ LOG via the TERMINATE_L9S command. Alternatively» the file 
created by the TERMINATE_LOG command should be used as input to these 
procedures to insure that all statistics have been evaluated, See the 
SAMPLE BATCH PROCEDURE described tater in this section. 


B1l.3 DISPLAY HPA LSUMMARY (OLS43) 


This procedure displays summary information in the following format? 
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descriptive data 


The descriptive data has the following format: 
<mf>o<pp>.<channel>.<controtierd>s«<unit>*<vsn>t<severity>*<symptom> 


where: severity can be UF (funrecovered failure) or RF (recovered 
failure). Entries wilt appear in ASCII collating sequence of the 
descriptive data string. 


This report uses the DISPLAY BINARY _LOG display_descriptive data 
subcommand. The report provides up to five sections depending on the 
types of statistics contained in SENGINEERING LOG. These sections can. 
be used to determine if the number of statistics reported against a 
subsystem warrant further inspection or maintenance activity. 


The descriptive data in this report is aiso the first tine in the tape 
and disk detail reports. It wiil be truncated at 56 characters and 
result in toss of message text when long <mf>» <controlierds, or <unit>d 
walues are used. PSR NVOES985 documents this problem. A value of 99 for 
PP number will occur when the failure occurs on the system deadstart 
device. 


Bl. DISPLAY HPA_DISK DETAIL (QL3H00) 


This procedure displays disk statistics in the following format: 
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<DISPLAYUBINARY_LOG header>d 
<statistic number> <julian date> 


GEN DETAIL STATUS 
FCN TY . UN CYL TK SC STAT 1 Fa 3 4 5 6 7 § 9 


hhimasss deeerletive date 


fen ty e un cyl tk se stat/ / / / / / / / / 
ERROR PQS cy! tk sc J , 7 j / / / / / 
FINAL STAT UNREC ERR stat/ / / / / / / / / 

/ f / i / / / / / 
OPCo= REQUEST RTY= SECTOR RTY2 RESIDUAL CNT# 


where? descriptive data is the same as In the summary report (up to 389 
characters long)» and the remaining tines are described as follows: 


<fenr<typed<eqd<unito<cylt track sector (INITIAL) ><gen status> + det stat 1-19 


ERROR POS <cyil track sector(FAILUREI> + det stat 11-20 


FINAL STAT UNREC ERR <gen stat(FATLURE)> # 2 X 10 det stat (only when UF) 


This report uses the DISPLAY UBINARY_LOS generate _group_filfe subcommand. 
The report provides up to four sections depending on the types of 
Statistics contained in SENGINEERING LOG. The entries in each section 
appear in chronological order. The values in the descriptive datas 
countss oped and equipment type are decimal. Att other values are 
octal. Ail fields are initialized to blanks» and onty valid data is 
quantified. 


Bl.5 DLSPLAY_HPA TAPE DETAIL _(QL34T9) 


This procedure displays tape statistics in the following format: 
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<DISPLAY_BINARY_LODG header> 
<statistic number>d €< julian date> 


STATUS 
ieee TP Pp CH rQ UN RTY DEN 6$1 Ge D383 DS4& OSS 056 ODST7 OdS8 
nitaweds jeeasio tive hae 
oped typ pp ch eq un rty dean. / / / / / ij / i 
FORMAT= / / / / / / / / 
BLOCK COUNTS CURR= READ= WRITTEN= 


where: descriptive data is the same as in the summary report (up to 86 
characters tong). Refer to Section A-5.6 for further details. 


This report uses the DISPLAY LBINARY_LOG generate_group_file subcommand. 
Currentiy the only statistic being logged for the tape subsystem is 
unrecovered 679 errors. The entries will appear in chronological order. 
The values in the descriptive data» countss opcd and equipment type are 
decimal. All other values are octal. All fieitds are initialized to 
blanks» and oniy valid data is quantified. 


Bl.6 SAMPLE BATCH PROCEDURE 
ae Create a permanent file containing the following procedure: 


PROC run_dish ( 
inputs i 3: file = S$local.~tengineering tog 
outputs o3 file = Stoutput 
status) 


display _hpa_disk_detail tvatuelinout) Svalueloutput) 
display _hpa_tape_detaii tvaluelCinput) tvaltueloutput) 
display _hpa_summary #valtue(input) Svalue{output) 


PROCEND run_dish 


be To run this procedure fron a terminal and display output to the 
terminals: 
1. Attach the file created in step a. as run _dish 
22 Enter “run dish" 


ce To run this procedure from a terminal and route the output to a 
printer: 
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1. Attach the file created in step ae as run_dish 
2e Enter "runuwdish o=list.teoi” 
32 Enter "print file list” 


d. To run this procedure fron a terminal with an alternate input 
files and route the output to a printer: 
i. Attach the file created in step a. as run dish 
2. Enter "runvldish i=<file> otlist.Seo0i" 
36 Enter "print file tist” 


NOTE — enter the characters between the quotes(™) followed by a carriage 
returns except for <file> which must be a file created by the 
TERMINATE_LOG commande. 
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C1.9 SUPPORT OF 7154 CONTROLLER 


C1.0 SUPPORT _QE_Z154. CONTROLLER 


The following information is provided for those sites installing NOS/VE 
on a configuration using 7154 controtiers. Users should be aware that 
NOS/VE support of 7154 controllers is olanned to be dropped in the 
futures This information is supplied as an appendix to the SRB and will 
not be incorporated into any manuals, 


To use a 7154 controlier in a NOS/VE systems make the following changes? 


1. Use 47154 _1 as the Product_Identification in Configuration Protog 
files. 


20 Use $7154_1 when defining the deadstart controlier,. 
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01.6 COMMAND TABLE GENERATOR 


D1i.0 COMMAND TABLE GENERATOR 
Diel CALLING THE COMMAND TABLE SENERATOR 


The generator is called via the Following NOS/VE command, 


generate _comnand_table | generate_command tables i? genct 
Linput=<file referenced] 
Loutpute<filie reference>] 
CUstatus*<status variabie>] 


input | i: This parameter specifies the Fille from which the gener etoy is 
to read the command table defintition, 


qi ston causes S$INPUT to be used. 


output ! o This parameter specifies the file to which the generator is 
to write the CYBIL declarations that represent the command table. 


Qmission causes $OUTPUT to he used. 
status? See ERROR HANDLING, 
D1.2 PNPUT_TO_THE_ GENERATOR 


The input to the generator is in the form of a series “commands” that 
deciare anew table or add entries to the "current table", 


There are three different commands: TABLE» COMMAND and FUNCTION. 
Each TABLE “command” starts anew command or function table and and is 
followed by any number of COMMAND “conmands™ or any number of FUNCTION 
"commands". An empty table may be defined by omitting COMMAND and 
FUNCTION "commands". 


D1le2el TABLE 
The TABLE “command” declares a new table, 
table name=<name>d 
Ctype=command : function] 


Csection names<name>j 
{[scopetiocai | xdcecl] 
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Cmodule=<name>] 


name ! nt: This parameter specifies the name of the table. This name can 
be no longer than 24 characters. 


type i t? This parameter specifies the type of table to be generated. 
Either a Command (C) or Function (F) table be selected. 


Omission causes a Command table to be generated. 


section name | sn: This parameter can be used to specify a section name 
for the CYS8IL variable declaration. The specified section must be 
read-only. 


Qmission causes no section name to be used. 

scope i st This parameter specifies the scope of the CYBIL variable 
deciaration. Specifying xXDCL causes that attribute to be used in 
the CYBIL variable declaration. Specifying LOCAL causes the STATIC 
attribute to be used. 


Omission causes LOCAL to be used, 


module } m: This parameter specifies the name to be given to a module to 
contain the command or function table. If this parameter is givens 
CYBIL module/modend statements are generated around the table 
declarations along with the approoriate SCU *COPY directives to 
reference the type definition decks. If the parameter is omitteds 
no module/modend statements or *cony directives are included in the 
generated output. 


D1l»2e2 COMMAND 


The COMMAND "command" dectares a group of entries in a command table. 
The order in which the names for the entries are provided has 
significance when the table is used by the system supplied 
DISPLAY _COMMAND_LIST command and in other similar contexts, The first 
entry name is taken to be the name "nominalt™ name for the commands ieee» 
the name by which it is usually known. The last entry name is taken to 
be the "abbreviation" for the conmand namee Any other entry names are 
considerred to be aliases for the command name. 


command namestist of <name> 
processor=<name> 
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Ccaliumethod=local ! xref ? toad } proc 7. program) 
Lavailability= sadvertised } hidden] 
Llogzsautomatic { manual] 


name } names i nt: This parameter specifies the names by which the 
command can be called. 


processor } oe: This parameter specifies the name of the processor for 
the command. 


cali_cmethod { cm: This parameter specifies how the processor for the 
command is to be invoked. 


LOCAL - indicates that the processor is a CYBIL procedure in the 
same module as the table. 


XREF —- indicates that the processor is a CYBIL procedure in a 
separate module fron the table. This option causes an XREF 
procedure declaration to be generated for the processor. 


LDAD - indicates that the processor is a CYBIL procedure that must 
be "dynamically floaded” (i.a~.» via pmptioad) before it can be 
called. 


PROC - indicates that the processor is an SCL procedure on one of 
the object libraries that comnorise the programe 


PROGRAM - indicates that the orocessor is desianated by a program 
description on one of the object tibraries that comprise the 
programe 


Omission causes LOCAL to be used, 


availability ¢$ at This oparaneter specifies whether the command is 
Advertised (A) to users or Hidden CH) from them. A "™hidden"™ 
command will not appear in a disolay of the command list entry. 


Omission causes ADVERTISED to be used. 


fog 3 13 This parameter determines whether the logging of a cal! to the 
command is Automatic (A)» 122. %is done by the SCL interpreters or 
Manual (M)» i-e. is done by the command processore Logging by a 
command processor is done in those situations where secure 
information potentialiy passed to the command should not be written 
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to the log. 
Omission causes AUTOMATIC to be used. 
D1l.e2e3 FUNCTION 


The FUNCTION *"command® declares a grouo of entries in aie function 
table. The order in which the names for the entries are provided has 
significance when the table is ysed by the systea supplied 
DISPLAY_COMMAND_LIST function and in other similar contexts. The first 
entry name is taken to be the name "nominali™ name for the functions 
feees the name by which it is usually known. The last entry name is 
taken to be the "abbreviation" for the function name. Any other entry 
mames are considerred to be aliases for the Function name. 


function name=list of <name> 
processor=Cname> 
Ccalit_methed=iocal $ xref | toad } proc] 
Cavailabilityztadvertised i hidden] 


mame } names $ nt This parameter specifies the names by which the 
function can be called. 


processor i} pt This parameter specifies the name of the processor for 
the function. 


cali_method 3 cmt This oparaneter specifies how the processor for the 
function is to be invoked. 


LOCAL - indicates that the processor is a CYBIL procedure in the 
same module as the tadte.’ 


XREF - jndicates that the processor is a CYS8IL procedure in a 
separate module from the table. This option causes an XREF 
procedure decfaration to be generated for the processore 


LOAD =- indicates that the processor is a CYBIL procedure that must 
be "dynamically toaded”™ (@.9.9 via pmp$ioad) before it can be 
calied. 


PROC - indicates that the processor is an SCL procedure on one of 
the object libraries that comprise the program. 


Omission causes LOCAL to be used. 
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availability i a: This parameter snecifies whether the function is 
Advertised (A) to users or Hidden {(H) from them <A "hidden" 
Function will not appear in a disolay of the function list. 


Qmission causes ADVERTISED to he used. 
Dle3 QUTPUT 


The output of the command tabte generator can best be described by an 
example. 


Examole_Ineut 


table example command_table.. 
section_namesosstjob_paged_Jiteral scope=xdci 

command (generate_command_tabdles aenerate_ command tables» agenct).. 
processor=clp$generate_command_table.. 

cali_method=xref 

command (display_command_lists discl).. 
processor=clotdisplay_command_list.. 
call _method=xref 


table example function_tabte tyoe=Ffunction 

function ttime processor=cip$3time 

function $peek processorz=cipttpeecek ayailability=hidden 
function $file processor=cipS$$file call _method=load 


Qutout fron cxanole Ineut 


VAR 
example command tables CXDCL» READ» osstjob_paged_ltiteral) 
“cit$command_tablie i= “exanple_command_table_entriess 


example -command table_entries:?: CSTATICs READ» 
ossi$job_paged_fiteral] array (1 .. 5] of 
cit$command table entry t= € 

{} CPDISCL "s cicSabbreviation entry» 
cictadvertised_lentrys 2» cictautomaticaily_logs 
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cicslinked_cails “clptdisolay_command_list]» 

{} C§'DISPLAY _COMMAND_LIST Fy cletnominal entry» 
cictadvertised_entrys 29 cictautomaticaily_log» 
cic$linked call» “clp$display_ command_Jlistis : 

{} [C*GENCT 's clc$abbreviated. entry, 
cictadvertised entry» 1» cictautomatically_log» 
cletiinked calls “clpt$generate_command_tablel» 

{} C'GENERATE_ COMMAND_ TABLE ', cic$noninal_entry» 
eclcSadvertised entry» ls» cictautomatically_log» 
cic$linked_catl», *clotgenerate_command_tablel» 

€} T' GENERATE COMMAND _ TABLES "s cictalias_lentr ys 
cicfadvertised entry» 1s cletautomatically_ logs 
cictlinked_calis *cloSagenerate_command_tabiel];3 


2? PUSH (LISTEXT t= ON) 2? 


PROCEDURE CXREF] clp$generate_command_table ( 
parameter_tabdlie: citS$parameter table; 
VAR status: ost$status); 


PROCEDURE CXREF] cl ptdisolay_command_tist { 
parameter_table: citSparameter table; 
VAR status! ost$status)3 


272 POP 2? 


VAR 
examoefte_function_tabie: C[STATICs READI 
“clt$function_table t= “example _function_table_entriess 


example function table entries: CSTATIC»s READI 
array (€1 «+ 31 of . 
cit$function_table_entry 3: [ 


{} C'SFILE *, cictnominal_entry» 
clegadvertised_entrys ls cictiinked_calls “*cips$filel, 

{} (C'SPEEK ', clctnominal_entry» 
clethidden_entrys 2» clictlinked_calls “cipt$peek I» 

{} CtSTIME ', cic$nominal_entrys 


cictadvertisedlentrys 4» clile$linked_calts *clos$$filej1;3 
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D2. 0 COMMAND EORMATTER 


D2.0 COMMAND FORMALIER 
D2.1 LNIRQDUCTION 


The command formatter is a tool used to format a file of SCL 
commands.» The formatter will read an input file of SCL commands and 
will generate a formatted output File, The input file may consist of 
one or more SCL PROCS or may consist of onty a portion of a PROC. 


Dé2e2 CALLING THE COMMAND FORMATIER 


The formatter is called via the following NOS/VE command, 


format iscl_oroc $$ format lscl_procs { forso 
Cinput=<file referenced] 
CToutpute<file reference>] 
Cpage_width=<integer>] 
Cinitial_indent_column=<integer>] 
(key _character= <character>] 
Cutility_definition_file=<file reference>] 
Cstatus=<status variable>) 


input 1? i: This parameter specifies the file from which the formatter is 
to read the SCL PROCS or commands. This file must have the 
following file attributes: 
access mode = read 
file contents = legidie or unknown 
file _processor # scl or unknown 
file structure = data or unknown 


Omisston causes $INPUT to be used, 


output 3} o3 This parameter specifies the file to which the formatter is 
to write the formatted SCL PROSs or commands. This file must he 
accessibie to write and must have the following file attributes: 
File_contents = legible or unknown 
file_processor = scl or unknown 
file structure = data or unknown 
If the file has never been onoeneds any of the above 3 attributes 
specified as unknown will be set to the alternate value. 
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Dmission causes $OUTPUT to be used. 


page width { pwt This parameter specifies the page width of the output 
File. The vatue specified for this parameter is considered to be 
the right-hand margin of the outout file. 


Qmission causes the valus of the page _width attribute of the output 
file to be used if the value was explicitly specified. If the 
attribute was not explicitiv specifieds 110 will be used. NOTE: 
The value of the page width parameter must be at least 64 greater 
than the vatue of the initial indent column parameter. 


initiallindent column i fic: This parameter specifies the starting 
column of the first tine written to the output file. This 
parameter is provided so that a section of commands (such as those 
appearing as input to COLLECTLTEXT) which wil not normally be 
formatted may be extracted From a PROCs formatted» and replaced in 
a formatted PROC. 


Omission will cause 1 to be used. 
NOTE: The value of the page_width parameter must be at least 
64 greater than the value of the inttial_indent_column parameter. 


key_character | kc: This parameter specifies the character whichs if 
appearing in column 1 of the inout tines wil! cause the entire tine 
to be written to the outout file without any other formatting 
processing. 


OQmission will cause * to be used, 

utility definition file } udf: This parameter specifies the file which 
contains definitions for additional utility commands which may 
appear in the input file. The utility names and terminators 
defined within in this file will be added to those built into the 
formatter. 
Omission will cause only the built-in utilities to be used, 


status: See ERROR HANDLING. 
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D203 INPUT _TO_THE FORMATTER 


The inout to the formatter is a file containing SCL commands. 
Usually the input consists of one or more PROCS —- starting with a PROC 
statement and ending with ai PROSEND statement; however it is not 
required that the input be complete PROCS. Any collection of SCL 
commands may be formatteds but SCL structure bjocks within the input 
file must be complete or the formatter will report errorse | 


D2e3e1 PRAGMATS 


Pragmats are special SCL comnents in the input file which control the 
formatting process. A pragmat is an SCL comment with $% (dollar-sign) as 
the first character of the comment. That iss a pragmat begins with the 
characters "$3 (double-quote dollar-sign) and is terminated with " 
{double-quote) or end-of-line. A pragmat may begin in any character 
position of a fine but only blank characters may precede a pragmat in a 
tinee The "command definition" of 4a opragnmat {where "%$ may be thought of 
as the "command") is: 


"S$ Ccommand=<name>d] Cformat=z<boolean>]) 


command { c: This parameter specifies the name of a utility command or a 
utility terminator. The purpose of this parameter is to inform the 
formatter that the utility names or terminators is "hidden" (such 
as being included in a file). Unoon encountering a pragmat with 
this parameters, the formatter will proceed as though the name had 
been encountered in the input and will adjust indentation 
accordingly. 


Qmission causes no change in indentation. 

format § fmt} f3 This parameter soecifies formatting action after the 
pragmat is processed. Note that if there is a command on the tine 
after the pragmat comment and seoarated from it by a semicolons the 
specified action will appiv to that command. 
Onission causes no change in formatting action. 

D2e3e2 UTILITY DEFINITION FILE 


The formatter maintains a tabte of known SCL utility names and 
terminatorse The utilities initially entered into this table are: 
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Utility Names Terminator Names 
ADMINSTER_USER» ADMYU QUITs QUI 
BACKUP _PERMANENTLFILES»s BACPF QUITs QUI 
BUILDLREAL_ MEMORY» BUIRM QUIT» QuI 
CREATE_LINTERSTATE CONNECTION, 

CREIC QUIT» QUI» DELIC>» 


QELETELINTERSTATE_ CONNECTION 
CREATE_OBJECT_LIBRARY» CREDL QUITs QUI 


EDITLFILE» EDIF QUIT» QUI» END 
EDITLLIBRARY» EDIL QUIT» QUI» END 
LINK _VIRTUAL_LENVIRONMENT>s 

LINVE QUITs QUI 
MEASURE_PROGRAM_LEXECUTION» 

MEAPE QUITs QUI 
RESTORE_LPERMANENT_FILES» RESPF QUITs QUT 
SOURCE _CODE_UTILITYs SCuU QUIT» QUI» END 


The user may augment this table by ganerating a utility definition file 
and specifying that file on the Formatter call. The file must consist 
of one Jine entries with the following “vnarameter fist”. 


names } name i ni This parameter snecifies a tist of names for one 
utility. Utility names must be unique, This parameter is 
required, 


terminators } terminator { t! This parameter specifies a tist of names 
which terminate the utility. 


Omission causes (quitsqui) to be used. 

Utility names must be unique and may not be the same as any of the 
"bullt in™ names. If the terminator nanes of a utitity inctude more 
than QUIT and QUI then ail terminators nust be specified. 

Exampies 

n=(my_utility» mud t=lendsquit»aui) 


namess{your_utilitys yu) 
its utility stop 


SOFTWARE RELEASE BULLETIN 


D2-5 
85/93/29 


NOS/VE Riele2 LEVEL 636 


SCL Tools 


AOR SRD AD OD NY VOR AD etn ED a 


D220 COMMAND FORMATTER 


D224 iUTPUT 


AS RN SONS HD HD HS AD OED eee ee we 


D2.4 QUTPUT 


The formatter generates lines in the output file according to the 
following conventions. 


l. 


36 


4% 


De 


5e 


Te 


8. 


If any input statement contains continuation liness all 
continuation tines will be read and concatenated with the 
beginning tine of thea statement before formatting of that 
statement begins. 


The "current indent column" will govern the starting column 
of the statement written to the output file. Initiatty the 
current indent column will) be column 1 (uniess overrriden by 
the initial indent column in the command call to the 
formatter). 


If the statement to be outnout (starting at the current indent 
column) is of such tfenath as to exceed the specified page 
widths then that statement will be broken at - if possibje - 
a reasonable place and as many continuation lines as required 
will be generated, 


A continuation line will be indented six (6) cotumns from the 
indent column of the first line of the statement, 


Breaking a tine at a "reasonable piace" means that items 
which are closely related to adjoining items wii! not be 
placed on separate tines untess there is no alternative. 


If an expression consisting of <Xoperand><oper ator><operand> 
must be brokens it wil! be broken immediately after the 
operator - or the space following the operator if one exists. 


In certain cases - a string too tong to fit on the entire 
lines for examole ~- indentation must be suppressed on the 
continuation line. 


If a statement consists of an SCL control statement which 
defines the beginning of an SCL structure block (IF»s for 
example)», then all statements following such a statement will 
be indented two (2) spacas From the control statement until 
the corresponding end statement CIFENDs for example) is 
encountered. 
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9. If a statement is tabeleds the tabel (followed by the 
continuation ellipses) will be placed on a line by itself 
indented two (2) columns jess than the current indent column 
({uniesss of courses the current indent column is fess than 


10. SCL control statement identifiers (IF» WHILE» PROCs etc.) 
along with certain control words (DO» EXIT,s etc.) will be 
written to the output file in uppercase. All other names 
(except certain utility names) will be written in lowercase. 


LL. Utilities will be treated as SCL structure oblocks. 


12. SCL comments will be retained and written to the output file. 
Comments at the beginnina of a statement (before the command 
name) will be written as separate lines and indented to the 
current indent column, An exception will be comments 
starting in column 1 of the Input file. Such comments wiil 
be written starting in column 1 of the output file. 


13. Spaces will be added or deteted as follows: 


aee A comma will be written with no leading space and with 
a trailing soace. 

bee The colon sepnarating the parameter name from the 
parameter specification in a PROC dectaration will have 
jeading spaces daleted and will be follwed by a space. 

Cee Contiguous spaces on Input will be output as one space. 

dee A space wil] precede and follow the equals sign of an 
assignment statement. 

@ee Unnecessary spaces in a parameter list will not be 
written. That is "command par name = parivaiue”"™ will 
be written as "conmand var unamespar_value™,. 

fee No rule in this sub-section will apply to characters 
inside a string or comnent expression. 


14. If multiple statements (separated by semi-colons) exist on an 
input tines, each statement will be formatted separately and 
the semi~colons discarded. 


15. If a statement terminator is optional (THEN of an IF 
statements for exanple)s the formatter will generate the 
terminator if it does not axist on the input statement. 
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16. COLLECT_TEXT (COLT) is treated as a special case since the 
text being cotiected may not be SCL statements. Whenever a 
collect text command is encountereds the parameter tist is 
scanned for the value of the UNTIL (U) parameter. If the 
UNTIL parameter is not specifieds or is specified as a 
fiteral strings formatting is turned off until the line 
containing the specified string (or **) is read, All 
collect text fines are copied to the output file without any 
other processing. If the UNTIL parameter is specified as a 
variable {other than a literal string)» formatting will not 
be turned off (since there is no way of knowing when it is to 
be reractivated) and the results may be undefined. The 
collect_text command wil! be output starting in column 1 with 
the command name written in uppercase. 


17. Any input line beginning with the key character specified in 
the call to the formnatter will be written directiy to the 
output file without any other processing attempted. 


18. If a statement formatted for output exceeds the maxinum 
command size (currently 236 characters)» any indentation 
present in the outout Jlinels) of the statement will be 
decremented until the naxinun command size is not exceeded, 
If deleting all indentation for the statement does not resuit 
in an acceptable command sizes a comment will be issued to 
the output file and the input tines) of the statement 
written instead of the formatted lines). 


19. If a blank tine does not Follow the fast tine of a proc 
deicarations, a blank tine will be added. If a blank line 
does not appear before a PROCEND statements a blank tine wil! 
be added. 


20. Certain errors (such as unbalanced parentheses) are detected 
by the formatter by calls to modified versions of some SCL 
interpreter procedures. Such errors are reported to the 
output file in the fornat of system error messages. The 
message mode (set by set _message_mode) will be reflected in 
these messages. 


Zi. If the formatter encounters a problem with a statement (such 
as not being abie to determine the UNTIL vatue of 
COLLECT_TEXT)» then a warning message will be written to the 
output file as a comment. 
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For each error or warning nessage written to the output file» 
the input Jine{s) in which the error was detected will 
immediatety follow the nessages 


Certain information about a fine in error may be retained by 
the formatter, For examptes, if a "WHEN" statement is 
recognized but an error is detected in some remaining portion 
of the statements a WHEN biock will still be established and 
will require a WHENEND statement. 


The formatter keeps track of SCL structure biocks in a 
somewhat different manner than the SCL interpreter. Whenever 
a statement specifying an end of a block (such as WHILEND) is 
encountereds the formatter checks that the biock exists. If 
it does and if any biock was started within the bijock being 
terminateds then a formatter error message will be generated 
indicating the line number of the statement beginning the 
blocke This means that If a PROCEND statement is encountered 
{and a PROC block exists)» then any unterminated block will 
be noted in an error messages 


In checking syntax and the likes the formatter assumes no 
knowledge of variable types or the likee For examples the 
statement 

IF 'this is a string’ # 255(10) THEN 
will be considered to be acceptable. That iss the formatter 
will detect only the most obvious errorse 


A count of error and warning messages issued will be 
maintained and reported to the status variable at termination 
of the formattere If the error count exceeds ai certain 
threshold (currently 25)»s the formatter will give ups feeling 
that it is probably orocessing unknown text. 


D205 EXAMPLES 


Input: 


proc aaa { 


inputsi 


t file = $REQUIRED 


outputs, o : files#$OQUTPUT 


status) 
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put_this _message_out ‘this is a message to be put to o- 
output’ o=Soutput 
edit_file xyz 
lasa 
include file abcc 
"S$ quit 
while labels while abcDdef do 
if hijz'2???!' then 
create_object_library 
add_module Fibra ya avesa ued ePanaelenevareeunenystaebedataias 
jximn2 
generate libdrary a 
quit 
elsesexit . 
ifend;whilendjsprocend 


Output: 


PROC aaa { 
inputs i: file = treauired 
outputs o: file = $output 
status). 


put this _message_out 'thnis is a message to be put to output’ .. 
o=$output 
EDITLFILE xyz 
loss a 
include file abcc 
"S$ quit 
white labels oe. 
WHILE abc > def DO 
IF hij = §222?" THEN 
CREATE_LOBJECT LIBRARY 
add_module library=tnve.abcdefghi jk imnoparstuvwxyzle. 
eabcdefghi jkimnd 
generate _library a 
QUIT 
ELSE 
EXIT 
IF END 
WHILEND while _tabel 


PROCEND aaa 
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Elel USING EDIT CATALOG 


EDIT_CATALOS (EDIC) is a full screen utility that allows you to view ana 
to manipulate the contents of NOS/VE files and catalogs. EDIC uses the 
terminal attribute terminal mod?! to determine the screen interface. 
EDIC includes the following general activities. 


Viewing a catalog or a file, 
Copying a file. 

Renaming a file within a catalog. 
Moving a file to another catalog. 
Creating a new file or catalogs: 
Switching to a different cataiog. 
Deleting a catalog or a file. 
Sorting a catalog displays: 
Locating a file within a catalog disolay. 
Executing a file. 

Printing a file. 

Displaying File attributes. 
Editing a file with FSE/VE. 
Executing NOS/VE commands. 


Ele2 CALLING EDITCATALOG 


The format for calling EDIT LCATALOS is as follows. 


ee 0© © © @® # @ &©& © © © © @ © 


EDIT_CATALOG (EDIC) 
CCATALOG*catalog] 
COISPLAY_OPTIGN=keyword valued 
(CNO_LDOLLAR_FILES=boolean_ value} 
CSTATUS VARTABLE=status variabte] 


The CATALOG (C) parameter specifies the catalog for which information is 
to be displayed. If you do not svecify a catalog names the system 
displays $CATALOG. 


The DISPLAY_OPTION (DO) paranetear specifies how much information that 
you wish to have displayed. The disoiay options are 
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Selects a dispiay that shows files and their cyctes only. 


ALL (A) 


Selects a display that shows files and 
Files 


For each 
and time. 


If the DISPLAY _OPTION parameter 


NOLDOLLAR_LFILES (NDF) 


TRUE 


FALSE 


the 


following 


is omitteds brief is selected, 


information 
sizes processors file types, and tast changed date 


Selects a display in which system file names 
{those beginning with a doflar sign) are not 
displ ayed. 


Selects a display that shows both system file 
names and user file names. 


A samplie EDIT_CATALOGS call 


fEDITLCATALOGG c=S$user doz=all nadf 


is shown below. 


This entry returns a screen simitar to the following sample dispiay. 


MY CATALOG 


OD ND A AD ND SE A AE OO ee ee ED ee ae ED ee 


Command Libraryez 


Cobol _Binary 

External 

oe a ooo + 

*+PRINT 3 | MOVE 3 

sVIEW § ¢ COPY ; 

$—— ewe + penne + 
Fl F2 


This display shows 


3 Size H i; Fite 
H (KB) H neers sor: H tyre 
——} di dain es ee eens im) sn Sse > H ot Sa 0m cae tS eh tae a sa H cm enti se snl se ss ms vad 
: 24 ; oc ; Library 
; +; Unknown $ Object 
H $ Catalog ; 
: H : 
; 1 : 
; H ; 
H H a 
$m meme} femme} femme w—K pe few we 
ICREATE? EXECUTE: $ 
$ EDIC ¢ DELETE §$ UNDO $ ¢ QUIT 
$m ene em Pe ee ee ee $ $e w mene 
F3 F4 F5 F6 
several cotunns of information 


Changed 
Date i Time 
ey Sra ees Senn eere 
B40813 : 10355 
840821 $ 09341 
a 
: 
; 
H 
+o nme e ee eto 
: + sLOCATE: 
:; SORT $ ATTRIB} 
a oe + 
F7 F8 
about files and 
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subcatatogs within the catalog you are currently viewings 


1. The Namescyclie column disolays the names of files within the 
catalog. A file name may be followed by a period and a cycle 
number. If the cycle number is 1» and there is only one cycles 
the cycle number is not disolayed. 


2° The Size column shows the size of the file in ei anes? Files 
fess than one kilobyte show a size of i. 


3e The Processor column shows the name of the processor that can 
handie the file. 


4%. The File Type cotumn displays the type category of the file. A 
file can de any one of four tyoes: legible» objects IJlibrarys or 
catalog. 


Legible means the file contains text that is human-readabie. 
§bject means the file contains compiler-generated object code, 
Library is a collection of object files. Catatog indicates a 
subcatalog of the currently displayed catatog. 


5.2 The Changed Date and Time column shows when the tast change was 
made to the file. The date is shown in yymndd format. Time is 
Shown in hhitmm formate If no changes have been made to a files 
this column displays the date and time the file was created. 


Some columns may be displayed as biank if their contents cannot be 
obtained. You may receive a disolay with some blank columns if: 


le You are not authorized to access the file. 

2~e The file is in use. 

3-¢ The catalog is $LOCAL. 
E1l.3 MOVING _ABDUT WITHIN _EDIT_CATALOS 
When using EDIT_CATALOGs, function keys enable you to move from screen to 
screen. If there are more entries in a catalog or more information in a 
file than fit on a single screen» vou can see the next sereen of 
information by pressing the FWD key. To return to the previous screens 


press the BKW key» When you reach the last screen of a catalog or a 
files a message is displayed in the upper right corner of the screen 
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stating "End of Catalog? or ‘End of File’. The UP and the DOWN keys are 
used for cursor positioning. 


If your terminal does not rave Function keyss there are alternate 
characters you can use to move from sereen to screen. You enter these 
characters in the first column of atline in the file display. The 
character entered determines the activity performed. Alternate 
characters and the actions performed are shown below, . 


CHARACTER ACTION CHARACTER ACTION 
+ FWD 4 HELP 
= BKW L LOCATE 
/ DOWN M ADVE 
* UP JN CREATE 
< BACK Pp PRINT 
A ATTRIBUTE Q QUIT 
C cOPY 5 SORT 
y DELETE U UNDO 
E EDIT v VIEW 
S EDIC X EXECUTE 


If you are using these alt2rnate characters» key prompts similar to 
those pelow will be displayed instead of the function key prompts shown 
earlier. 


MY_CATALOG 
Se gs ay Ps Size i$ Fille? Changed 
NBR Rey olS (KB) Processor ; Type Date  { Time 
iain ns an xs ts Se mm cs sm it Su idee iam sini san’ ©. nibs eins sommes cans ce i> eens -asin iw nn tue ‘ean ema 8 ee ee ee we ee mae sem ame same amie ene sie Ye am ae aie ae eam nD ah atte aoe 
Command _Librarye2 224 gc : Library! 840813 10355 
Cobol_ Binary Unknown Db ject 840821 09341 
External Catatog 


ene C8 we we £8 © 8 Be ot Be 
ee 2S £26 we te Oe we ae He we 
we be 2a 682 &2e 86 we ee we 


+=FWD -=BKW *=UP /=DOWN C=BACK AzAttrib C=zCopy D=Delete E=Edit G=Goto 
H=HELP LeLocate N=New P=Print Q=Quit $=Sort UzUndo VzView XsExecute 
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Ei.4 eer een eee 


EDIC displays informational messages and error messages in different 
WaySe 7 


1. If a message is an informational or a non-error type prompting 
message generated by EDICs the message is displayed on the message 
jine which is one tine below the home line when the nome tine is 
at the top of the screen and one ahove the home tine when the home 
line is at the bottom of the screen. {There is one exception to 
thise When deleting a catalogs the informational message stating 
a catalog DELETE cannot be %UYNDOne appears in a window in the 
center of the display with two function keys tlabeled OK and 
CANCEL.) 


2. If the message results from an error reported by a part of the 
system that performs user-reguested functionss EDIC opens a window 
in the middie of the cataiog display and shows the message there. 


£1.5 EXITING EDIT CATALOG 


i 3 
3 ‘4 
Fo=-==> + QUIT 3 
+ + 


Pressing the QUIT key takes you out of EDIT CATALOG at any time. Your 
working catalog is restored to what it was when you entered EXICs 
regardiess of which catalog you were viewing when you pressed QUIT. 


Deleted files that have not beer UNDIne are deleted at this time. {See 
Undoing File Deletions tater in this chapter.) If there is a problem 
with the deletion of a files you will be informed of the error. The 
probiem file is not deleted and the detetion process continues with 
subsequent Files in the delete list. 


El.6 EDIT CATALOG FEATURES 
EDIT_CATALOG simplifies many cOnmmOn procedures used in file and catalog 


management. Using this utility reduces the number of keystrokes 
required and speeds processing. 
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Fi=+==> VIEW 


When it is calledsy EDIC initially disoltays the catalog specified on the 
first parameter entered, For examoles if you enter EDIC SUSER» your 
$USER catalog is displayede The disoiay contains several cotumns of 
information about the files and the subcatalogs within the catalog 
specified» If you omit the first parameters you get a display of your 
current working catalog. 


If you wish to see the contents of a particular entry on the displays 
use the arrow keys to position the cursor on the iine of the entry and 
press the VIEW keye If the entry selected is a files the first screen 
of the file will be displayed on a separate screen, If the entry 
selected is a subcatalog» entries in the subcatalog will be disptayed on 
the screen, 


The screens displaying the selected file or subcatalog provide key 
prompts instructing you how to nove about within the file or subcatalog. 
Pressing the BACK key returns you to the previous catalog you were 
viewing or to the catalog immediately adove the currently displayed 
catalog. 


Ele5e2 CREATING A NEW CATALOG OR FILE 


4 em me + 
F3---> # CREATE 3. 

sEDTL H 

$ meen a + 


You can create anew file or new catalog within the currentiy displayed 
catalog by pressing the CREATE key. After pressing the CREATE keys the. 
following prompt is displayed: 


--Enter file name to create a file3} name.e to create a catalog 
To create anew file» enter the fille name on the home fine and press 


RETURN. You will be taken to the Full Screen Editor to create the 
contents of the new file. 
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If you decide not to create a new Files press the BACK key to cancel the 
CREATE. EDIC will then disptay the following message! 


--Creation not done 


To create a new catalogs enter the catatog name followed by a period on 
the home line and press RETURN. The following message is displayed? 


--Catalog created 
After you have created a new catalogs vou can move or copy files to ite 
If you have created a new cataiog and you then decide you do not want 
the catalogs», follow the instructions given in the Deleting a Catalog or 


File heading Tater in this chapter, 


E1le5e3 SWITCHING CATALOGS 


pon =-+ 
«CREATE! 

F3---> ff01C 3 
$------ + 


Your working catalog is the catalog you currently are viewing. You can 
switch and edit a different catalog by pressing the EDIC key. You then 
see the following prompt? 


--Enter catalog name to switch to 
Enter the name of the catafog you want to edit and press RETURN. 
The catalog name you enter is treated according to the NOS/VE rules for 
catalog path names. If the name starts with a period it is an absolute 
pathe Thuss the entry -YOUR_NAME takes you to the path YOUR_NAME. 
If you enter a name without a teading periods you are referencing a 
subcatiog of the current catalog. For examples if you are viewing 
$SYSTEM and you enter MANUALS» vou will be switched to $SSYSTEM.MANUALS. 
There is» howevers an easier way to access a SUbcatalog of the current 
catalog. Simply oeosition the cursor on the line that contains the 
subcatalog name and press the VIEW key. 


If you decide not to switch catalogs» oress the BACK key before entering 
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Ele6e3 SWITCHING CATALOGS 


anew catalog name. The system disviays the Foliowing message3 
-~Catalog not changed 


El.6e4 DELETING A CATALOG OR FILE 


ro 
i XECUTES 
Fam) >DELETE? 
$ en + 


You can delete a catalog or file by oositioning the cursor on the tine 
of the entry you want to delete and pressing the DELETE key. The entry 
is hightiighted and then erased from the display. Howevers the entry is 
not fully deleted until you exit EN IT_LCATALOG. 


If you detete an entry by mistakes vou may be able to correct the error, 
Some files can be restored by pressing the UNDO key. Multiple file 
restores are done in the reverse order in which they were deleted, Each 
time you oress the UNDO keys the cursor position shifts to the newly 
restored file. 


Deletion of catalogs» files in LOCAL» and files with more than one 
cycle cannot be UNDOne.e When you make these types of deletions you will 
receive the following warning? 

~“e-Delete of a catalog cannot be JNDOne 


Ele6e5 UNDOING FILE DELETIONS 


fone + 
H H 
F5--~-> ; UNDO } 
dp ne ae ee we 


File restores are done in the reverse order in which they were deleted. 
tach UNDO positions the cursor to the newly restored file (possibly 
changing catalogs to do soe Files are fully deteted only when you 
leave EDIT_CATALOG. 


If no files have been deleted prior to overforming an UNDOs you will 
receive the following message? 


~-No deletes to UNDO 
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£124.25 SORTING THE CATALOG DISPLAY 
+ ee + 
F5<--——> 3. H 
*; UNDO ? 
S eeeteeeee o 
You can sort entries in any one of the five columns. You can sort 


entries bys: 


* Name 

» size 

® Processor 

» Changed Date/Time 


To sort entriess press the SORT kay. Each column is then numbered with 
a numeric overlay on top of the text and a prompt is displayed in the 
upper-right corner of the display. 


- Enter number of fieid to sort on 


; ; 1 File : Changed 
Nameecycle : Size ; Processor { Type ; bare $} Time 
ae ee ae een oe san en em ee ne mo eee RE A A EE ES an he A A : ee ee ae ae on ee ae f A A he ete wee EN ec, OE INE DEE TE : Et eg) WR AI Aste tei ORES KER I ee OR ce con 
a a 3 4 
r) a ’ a 
i 13 + $$ 23 ; ; 3 4 >; § 4 5$ : 35 $ 
pw we } . mee 4 eo ‘ te : fmm } 
8 & ) 3 
r a a 4 


Enter the number of the column by which you want to sort the display and 
press RETURN. The screen is eras2ad and redisplayed with the entries 
sorted according to the field you chose. 


Press BACK if you decide not to sort. The system redisplays the screen 
without the numeric overlays and the foltowing message is displayed: 


“~-Sort not done 
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Elbe? COPYING A FILE 


Fe---> {| CqeY } 


You can copy a file by positioning the cursor over the name of the file 
you want to copy and pressing the COPY key.» The file entry will be 
hightighted and you will see the following prompts 


~-Enter name to copy to 


Enter the name of the destination file to which you want the original 
file copied. . 


The destination file name you enter can be a file name or a path name. 
If you enter a file name tor a File nane.~cycie number) the copy will be 
Placed in a destination file within the cataiog you are viewing. To 
copy a file to a destination file in a different catalog» you must enter 
a path name. For examples to copy a file to a destination file called 
NEW in subcataiog MINE»s enter $JSER.MINE,ANEW as the destination file 
Name » 


A shorthand notation is provided for copying between catalogs. Type the 
path name up to and including the oeriod oreceding the name of the file 
in the destination catalog and press RETURN. EDIC assumes you want the 
file to have the same name in the destination catalog as it has in the 
current catalog. 


if you copy a file to a non-existent files you get an exact 
byte-for-byte copy with all the original file attributes oreserved 
(except ring attributes). 


If the target of the copy exists and has different file attributes from 
the source filles a record=-hby-record copy will be made (providing the 
attributes are compatible). 


If you decide not to copy a files oress the BACK keye The file entry is 
no longer highlighted and the following message is displayed: 


--Copy not made 
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E1.668 LOCATING A FILE 


tos ATE? 
6-2? sATTRIBI 


You can focate a particular file within a catalog using the LOCATE key, 
When you press this key you see the Following prompt: 


~-Enter name to locate 


Enter all or part of the file name you wish to locate and press RETURN. 
If the file name is founds the cursor witl move to the name of that 
file. If the file is not focateds the following message appears on your 
screen; 


--NOT FOUND 


A feature cailed "wild cards" is provided to help you search for fiie 
namese The simpfiest form of a wild card is the question mark (?) 
character. The question mark can represent any singie. character in a 
file name. For examples to find all your files whose names begin with a 
character followed by BC} you would search for ?8C. The question mark 
can be used in any character position. 


Another type of wild card is the asterisk (*) character. Like the 
question mark, the asterisk can reoreseant any character. Howevers the 
asterisk can represent any runber of characterss not just one. For 
examples you enter SV*¥ to find all vour files that begin with SV. The 
SV matches the first two characters of the file name and the asterisk 
matches the rest of the name. To find atl the files with SOURCE as part 
of the names you would enter *S)URSE*, 


For examples if you entered the followings: 
2a --Enter nane to locate 
adisplay simiftar to the following would be returned. 


=-Select entry with cursor and oress RETURN or press RETURN 
- Disolaying jocated files 
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iin oe 


The list of ftocated files appears on a Separate displaye You can choose 
a particular file by placing the cursor on the line where the file name 
appears and pressing RETURN. If you decide not to tfocate any files» 
press the BACK keye No message is disolayed. 


E1.6¢9 MOVING OR RENAMING A FIL? 


Pos 


1 SD ae a ee aT. 


You can move a file to a new catalog or rename a file within the same 
catalog by positioning the cursor to the tine where the flie name is 
displayed and pressing the MOVE key. The file entry will be highlighted 
and you will see the following promots 


--Enter name to move 


If you want to move a file to another catalogs enter the path name and 
press RETURN. The system displays the following message? 


~-File noved 


A shorthand notation is provided for noving a file between catalogs. 
Type the path name up to and including the period preceding the name of 
the file in the destination catalog and press RETURN. EDIC assumes you 
want the file to have the same name in the destination catalog as in the 
current one. 


If you want to rename a file in the the current catalogs enter the new 
file name and press RETURN. The foltowing message is returneds 


-~File renamed 


ae | 3 E1-13 
SOFTWARE RELEASE BULLETIN 
85/03/29 
NOS/VE Ri.l.2 LEVEL 630 
EDIT_CATALQG 
.0 EDIT_CATALOG 
2659 MOVING OR RENAMING A FIL 


CAE SND AE ND AE ED A ED AOD HN END AAO AN AND SAE ORD NUD SE ANY AN ET SEND RN DD OE: SEED ERED ARS TREND ANNE: GUY SOND: ONE WORD VD NERS -eRE NERmD OTE ORD “NLA ARN AED SO NNN RD SHUN AUER ON WE GORD ERS SION NE EN-RD RD AE TD NED OEP AED ER AOE WED AE aE -stD 


If you decide not to move or rename a files press the BACK key to cancel 
the operation. The system responds with the following message! 


~-File not moved 
E1l.6.10 EXECUTING A FILE 


fomnn ant 
F7--~> *KXECUTS! 
tDELETES 


You can execute an SCL or object file using the XECUTE key. Position 
the cursor on the line of the file you want to execute and press the 


The File entry is highlighted and you see the following prompt: 
“~-Enter parameters or press 25 TURN If none 


Enter any parameters you wish to add and press RETURN. Ors if you 
prefer not to suppiy any parameters» simply press RETURN. The program 
will then execute. During execution the screen is blank except for the 
following message? 


--Executing command 
The blank screen allows any progran outout to be clearly visible, 


When execution is completes processing pauses. This pause gives you 
time to read any interactive outout oroduced by your program before the 
catalog display overwrites it. When you have read the outputs press 
RETURN to go back to the catalog display. 


If you decide not to execute a files press the BACK keye Highlighting 
disappearss but no message is displayed. 


Ele6e11 EDITING A FILE 


You can edit a file using the NOS/VE Full Screen Editor (FSE) by placing 
the cursor on the line that disotavs the name of the file you wish to 
edit and pressing the EDIT keys You are taken automatically into the 
Fuli Screen Editor. 
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When. you are done editing the files fteave the editor in the same manner 
you normally use to end an editing session. You are returned to EDIC 
exactiy where you left it. 


Ele5e12 PRINTING A FILE 
his=<> tPRINT 1 
a 


; VIEW 


You can print a file using the PRINT kaye. Place the cursor on the line 
oF the file you want to print and oress the PRINT key. The entry is 
highlighted and you are asked? 

~~What is your bin number? 


Enter your bin number and opress 2ETURN, The system returns the 
following message: . 


--File sent to printer 
The file is sent to the central site line printer. 
€1.6.213 DISPLAYING FILE ATTRIBUTES 
roe ATE? 


ro-=—> tATTRIBSE 


You can display the file attributes for a file by positioning the cursor 
on the file name Line and pressing the ATTRIB key. You will then see a 
separate display similar to the one shown below. This dispiay shows the 
most frequentiy referenced file attributes. 


“--File attributes of SMYFILE 


File_organizations: SEQUENTIAL Size? 1312 

Block type: SYSTEM_SPECIFIED Record type: VARIABLE 
Maximum record tength: 256 Maximum_record ftength: 0 
Access_mode: READ APPEND Maximum block length: 18 


Open position: $BO0T 
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When the new set of function keys apoears at the bottom of the screens 
press the SceALL key if you wish to see a pageable display of ali of the 
file's attributes. Pressing the B83ACK key returns you to the main 
cataiog displaye Pressing QUIT takes you out of EDIC. 


EleSel4 cXECUTING NOS/VE COMMANDS 
You can execute NOS/VE commands by moving the cursor to the home line 
and typing the command preceded by a slash. For examples to display the 
current working catalogs enter the following command: 

7DISC SC ATALOG 


After typing the command informations press the RETURN keys ODOuring 
execution the screen is blank exceot for the following message? 


-~-Executing command 


The blank screen allows any system response to the command to be clearly 
visiodle. 


When execution of the command is completes, press RETURN to restore the 
current catalog disptay. 
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F1le9 NOS/VE_DUMP ANALYZER 


The NOS/VE Dump Analyzer is a NOS/VE utility provided to aid in the 
analysis of NOS/VE system failures and Cyber 180 hardware failures. The 
Dump Analyzer accesses a tape created by the Express Deadstart Dump 
(EDD) deadstart utility. The NVE subsystem may aiso produce a dumo tape 
in the event of a NOS/VE failure. This tape is compatibie with tapes 
produced by EDD and is therefore acceotabie as input to the dump 
analyzer, 


You may use the dump analyzer either interactively or run from a 
procedure or an INCLUDE_LFILE as part of a batch or interactive job. The 
dump analyzer is implemented as a comnnand utility. Subcommands are 
available to display the following information: 


1. Central memorys displayed in numeric and ascii formats accessed in 
virtual or real address mode,: 


Ze Peripheral processor memory. 
36 Maintenance registers for the I9Us memory and processors. 
4. Formatted dispiay of exchange packages. 
5. Process information resuiting Fron an analysis of stack segments. 
Fiel ANAD (ANALYZE_DUMP) 
Purpose? The ANALYZE_LDOUMP command invokes the dump analyzer utility. 
Formats: ANALYZE_DUMP 
dump _ file = file reference 
restart_file = file reference 
debug_table = file reference or keyword value 
title = string 
output = file reference 
status * status variable 


Parameters: dump _fite (df) 


Specifies the dump to ba analyzede There is no default for 
this parameter. If omitteds it is assumed that the restart 
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file contains the dumo Information. [If dump file is 
omitted and the restart file is empty or non-existents an 
error status is returned. 


restart file (rf) 


The restart file is aither an input file or an output files 
depending on whether the dump_file parameter is specified. 
If dump_file is soecifieds a restart file is written to 
this file.This file is accessed during the execution of the 
dump analyzers. If you do not specify a dump _file parameters 
the restart file indicates a file created from a dump by a 
previous execution of the analyze dump utility. If you do 
not specify this parameters the vaiue Slocal.restartfile 
to be used. 


debug_table (dt) 


Generates symbolic names from addresses and addresses from 
symbolic names. This table is built when the system is 
generated. It is included in the generated system and is 
also saved on a file. If the dump is being analyzed on the 
same system as the dunvoed system then the debug table in 
the running systen nay be used. Otherwiser specify the 
File name of the File saved from the system generation. 
Specify the xeyword "none" if no debug tabie is to be 
accessed. If you do not specify this parameters the running 
system debug table is used. 


tittle (t) 

A string of 1 to 25 characters may be specified and is 
included in the page headers if these headers are 
generated. If you do not soecify this parameters the 
string "ANALYZE_DUMP Varsion 1.0' is usede 

output (0) 


Establishes the default outout file for all subcommands. 
This default may be overriden with the output parameter on 
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each subcommand. If you do not specify this Saeeerebs: the 
value Soutput is used. 


status 


Optional status variable. 


Remarks? Analyze dump does not request a tape. You must supply the 
— REQUEST MAGNETIC TAPE command prior to invoking ANALYZE_ 
DUMP. 
Examples /reqguest_magnetic.tane tlocal.adump type=mt9%6250 .. 


evsnz'idmpooi't 
/analyze_dump dump_file=S$local.dump restart file=.. 
$user.dmpool 
ad/quit 
Janalyze_dump rf=Suser.dnpool 
ad/ 
Fl.2 DUMP ANALYZER SUBCOMMANDS 
The following subcommands are described in this section? 
© CHANGE_DEFAULT (CHAD) 
» CHANGE PROCESSOR_LREGISTER (CHAPR) 
« COPY_LMEMORY (COPM) 
e COPY LPPLMEMDRY (COPPM) 
e DISPLAY_CALL (DISC) 
» DISPLAY EXCHANGE PACKAGE (DISE?) 
e DISPLAY MAINTENANCE _REGISTERS (OTSMR) 
» OTSPLAY_MEMORY (DIS») 
e DISPLAY PPL MEMORY (DISPM) 


» QUIT (Qut) 
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Fl.2.1 (CHAD) CHANGE _ DEFAULT 


Purpose? This subcommand allows you to change the default setting of 
certain parameters on dump analyzer subcommands. 


‘Format: CHANGE DEFAULT 
exchange = integer or keyword value 
processor = integer 
bytes = integer 
address mode = keyword value 
words = integer 
status = status variabte 


Parameters: exchange (e) 


If you specify this oarameters the vaiue supplied is used 
as the default setting for all subsequent subcommands and 
functions which acceot the exchange parameter. Allowable 
values are the keywords monitors ms» jobs» j or an integer 
value. If this parameter is not specified» the default is 
not changed. 


processor (p) 


If you specify this parameters, the vatue supplied is used 
as the default setting for all subsequent subcommands and 
functions which acceot the processor parametere Allowable 
values are integers hbeatweean 0 and 3. If this parameter is 
not specifieds the default is not changed, 


bytes (b) 


If you specify this parameters the value suppiied is used 
as the default settina for the bytes parameter on the 
DISPLAY_UMEMORY subcommand. Allowable values are integers 
between © and 335546432. [If you do not specify this 
parameters the default is not changed, 
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address_mode (am) 


If you specify this oarameters the vaiue supplied is used 
as the default setting for all subsequent subcommands and 
functions which accent the address_mode parameter. 
Allowable values are the keywords process_virtual_addressy» 
Ppvas system _virtual address» svas real_memory_ address and 
rma. If you do not “soecify this parameters the default is 
not changed. 


words (w) 

If you specify this parameters, the value supplied is used 
as the defauit setting for the words parameter on the 
DISPLAY PP_UMEMORY subcommand. Allowable values are 
integers between ) and 4096. If you do not specify this 
parameters the default is not changed. 


Status 


Optional status variable, 


Examples ad/change_default e=nonitor 
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Purpose? This subcommand alfows you to change the setting of the 


processor registers which are used for virtual address 
transtation. These registers are initialized in the dump 
analyzer from their settings in the processor maintenance 
registers. 


Format: CHANGE PROCESSOR REGISTER 
job _process_ state = integer 
monitor process state = integer 
page_size_mask = integer 
page_table_address = integer 
page _table_length * integer 
processor = integer 
status = status variable 


Parameters? job _process_state (jos) 


Subcommands and functions which use the exchange parameter 
can obtain a real menory address from the maintenance 
registers to use as the location of the exchange package. 
This occurs if the exchange parameter is equated to either 
job or monitor. When equated to jobs the value of the jps 
register is used as the exchange address. 


The jps parameter allows you to change the value that is 
used when the exchange parameter is equated to job. 

monitor wprocess_state (mps) 

The mps parameter allows you to change the value that is 
used when the exchange parameter is equated to monitor, 
page_size_mask (psm) 

The page size mask correlates directly to a page sizes The 


following table shows the allowable values for page size 
mask and the resulting page size? 
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page size mask page size (bytes) 
7F(18) §12(10) 
7e(1d) 1624(15) 
7¢e(16) 2048(10) 
78(15) 4096(10) 
7016) 8192(10) 
60(16) 16384(10) 
4016) 32768(19) 
¢ 65536(10) 


For this subcommands enter the page size mask settings not 
the page size. 

page_table_address (ota) 

The page table address is specified as the actual real 
memory starting address of the page table. 
page_table_length (ntl) 


The following table shows the allowable values for page 
table length register and the resuiting page table length: 


page tabie length register page table tength (bytes) 
0 0 4696110) 
1 0 819210) 
3 3 16384(10) 
7 7 32768(10) 
OF{15) — 65536(10) 
1f(15) 131072(10) 
3f(15) 262144(10) 
7F(14) 524283(10) 
off (16) 1048576(16) 


For this subcommands enter the setting of the page table 
length registers not the actual page table tength. 


processor {p) 
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The processor parameter specifies which processor is to be 
selected for the subcommand in a multi-processor 
environment. 


Allowable values are 9 threugh 3. Omission causes G to be 
used. 


Status 


Optional status variable. 


Exampie3 ad/change_processor_register jps24d4426(16) 
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Purpose: 


Format: 


Parameters: 


(COPY_MEMORY) 


Copies central menory to a file. The address of the memory 
to be copied can be soecified as a process virtual address 
(pva)» a system virtual address (sva) or as areal memory 
address(rma). The memory is copied exactly as it exists in 
the dumpe 


COPY_UMEMORY 

address = integer 

file = file reference 

byte _count = Integer 

exchange = integer or keyword vaiue 
processor = integer 

address mode = keyword value 

status = status variable 


address (a) 

Specifies the address of the memory to be copied. Its 
format depends on the value supptied for the address_mode 
parameter. 


This parameter is required. 


file (f) 
Specifies the file to which the memory is copied. 


This parameter is required. 


byte count (bc) 
Indicates the number of bytes to be copied. 


If you do not soecify this oarameters a default value of 
100000(16) bytes is used. 
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exchange (e) 


Designates the exchange package to be used to define the 
wirtual address. An integer value is interpreted as the 
starting real memory address of an exchange package. 


The following keywords may aiso be used? 
Active (a) 


indicates that the contents of the CPU at the time of 
the dump are to be used. 


Monitor (m) 


indicates that the processor maintenance registers are 
to be accessed and the value in the MPS register be 
used as the real memory address of the exchange 
package. 


Job (9) indicates that the processor maintenance 
registers are to be accessed and the vaiue in the 
JPS register used as the real memory address of the 
exchange package. . 


If you do not specify COPY_MEMORY»s the active exchange 
package is used. 


processor {p) 


Specifies which processor is to be selected for the 
subcommand in a mutti-orocessor environment. The processor 
determines which set of naintenance registers are to be 
used for virtual addressing parameters page size masks page 
table address and oaqge size maske In addition if job or 
monitor is specified for the exchange parameter, the jps or 
mps register for that processor will be accessed. If 
active is specified for exchanges the processor parameter 
determines which pracessor's active exchange package is to 
be used. 


Allowable values are 9 through 3. If you do not specify a 
parameters a default vatue of 0 is used. 
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Remarks: 


Examples 


address_mode (am) 


Determines the interoretation of the address parameter, 
Possibie settings are: 


process virtual address (pva) causes interpretation as 
follows? 


sssnnannannoan(ti15) with s being the segment 
number and n the offsets 


system _virtual_address (sva) causes interoretation as 
Follows: . | 


aaaannnnannnn(16) With a being the assigned 
segment identifier f{asid) and 
n is the offset. 


real_memory_address (rna) specifies the starting reali 
memory byte address to he copied. 


If you do not specify this parameters a default of process_ 
virtual_address is used. 


Status 


Optional status variable. 


COPY_MEMORY is useful for determining which portion of 
virtual memory is paged In by copying the memory to file 
tnull. 


ad/copy_memory a=3909000009(16) fetuseresegment_3 e-« 
bo=10000(16) 

ad/copm 990009009000(145) tnul!l 2000C(15) 

--WARNING-—- Virtual menory from offset 0416) to OFFF(16) 

is paged out. 

~-WARNING-— Virtual manory from offset 2000(15) to 

LEFFFF(16) is paged out. 
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WARNING=—- Not ail, memory requested was copied: a page 
fault was encountered, 
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F1l.264 COPPM (COPY_LPP_MEMORY) 
Purpose: copies peripheral processor memory to a file. 
Formats: Copy _pp_memory 
po number = integer 
file = file reference 
address = integer 
word count # integer 
status = status variable 
Parameters: pp_number fon) 


Specifies the number of the peripheral processor whose 
memory is to be copied to a file, 


This parameter is required, 


file (f) 
Specifies the file to which the memory is copied. 


This parameter is required. 


address (a) 

Specifies the starting address in pp memory of the copye 

If you do not specify a value for this parameters, a default 
value of 0 is used. 

word count (we) 

Indicates the number of words to be copied. 


If you do not spacify a value for this parameters a default 
value of 4096 words (the entire pp) is copied. 


status 
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Detional status variable,.: 


cxamples: ad/cooy _pp_memory 4 fzSusereop_4 
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Fil.e2e5 DISC (DISPLAY CALL) 


Purpose? The DISPLAY CALL subcommand produces a formatted diseolay of 
the dynamic cali chain for a selected task. 


Formats: DISPLAY_CALL 
exchange = integer or keyword vaiue 
processor * integer 
count = integer or keyword value 
start = integer or keyword value 
display _option = list of keyword value 
titie = string 
output = file reference 
status = status variable 


Parameters? exchange (e) 


Designates the exchange oackage to be used for the 
analysis. The exchange vackage defines the process whose 
call chain is being disoltayed. An integer value is 
interpreted as the starting real memory address of an 
exchange package. 


The following keywords may also be used? 


active (a) indicates that the contents of the 
processor at the time of the dump are to be used, 


monitor (m) indicates that the processor naintenance 
registers are to be accesseds and the value in the MPS 
register used as the real memory address of the 
exchange package. 


job (j) Indicates that the processor maintenance 
registers are to be accessed and the value in the JPS§ 
register used as the real memory address of the 
exchange package. 


If you do not specify this parameter» the active exchange 
package is used. 
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processor (p) 


Specifies which processor is to be selected for the 
subcommand in a multi-orocessor environment. The processor 
determines which set of maintenance registers are to be 
used for virtual addressing parameterss page table address» 
and page size mas«. In additions if job or monitor is 
specified for DISPLAY _SALL (disc)s the exchange parameter 
(the jps or mps register for that processor) will be 
accessed. If active is specified for the exchanges the 
processor parameter determines which processor's active 
exchange package is to be used. 


Allowable values are 90 through 3.2 If you do not specify a 
value for this parameters a default value of 0 is used. 


count tc) 


Number of stack frames to be displayed or the keywords 
Mali". If the value given is greater than the number of 
existing framess all are disolayed. 


If you do not specify this parameter, the entire call chain 
is displayed, 


start (s) 


The start parameter indicates which frame in the cail chain 
will begin the display. Frame one represents the most 
recent cail or trap. Start may also specify the keyword 
EXCHANGE PACKAGE. This begins the display with a formatted 
display of the exchange packages and then displays stack 
frames starting with one. 


If you do not specify this parameters the keyword "“exchange_ 
Package™ is used. 

display options (display_loptions do). 

The following display options are provided: 


brief (b) - provides a minimum display. 
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Examples: 


Frame 13 
Frame 22 


full (fF) - provides a nore detailed display. 


save (s) ~- displays the contents of the stack frame 
save area in hexadecimal interpretation. 


You can use a list of keywordss but full and brief cannot 
be used together. 


If you do not specify an options a display_option default 
of brief is used. 
Title (t) 


Specifies a string of 1 to 31 characters which is included 
in the page headers if these headers are generated. 


If you do not specify a tities the string 'display_call! is 
used. 


Dutput (0) 


File receiving the disolay. If you do not specify an out 
put Files the vaiue soecified on the ANALYZE _DUMP command 
output parameter is used. 


Status 


Optional status variable, 


ad/display_cal! a= job 
Exchange address = 5654A9(16) 


Exchange package: PROCESS COMMAND_LIN_LIST + AQ(16) in 
CLMSPROCESS_ COMMANDS 
monitor conditions: page table search without find 


CLPSPROCESS_ COMMAND + 582(16) in CLMSPROCESS COMMANDS 
PROCESS COMMAND + 100145) In CLAMSINCLUDE 
The on condition flag is set for this frame. 
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Frame 32 PROCESS COMMAND LINE + 559116) in CLMSINCLUDE 
Frame 4: CiLPSSCAN_COMMAND_LINE + 42416) in CLMSINCLUDE 


Frame 53 P= B 42 6842C 
Frame 63: P= 8 42 6CE82 
Frame 7? P# 8B 42 6DB49 


The critical frame flag is set for this frame. 
The on condition flag is set for this frame. 
Frame 8: P# B 4&2 5EIF4 . 
The critical frama Flag is set for this frame. 
The on condition Flag is set for this frame. 
Frame 93 PMPSORIGINAL_CALLER + 186116) in PMMSOUTWARD_CALL 
The critical frame flag is set for this frame. 
The on condition Flag is set for this frame. 
Display terminated: end of call chain encountered in 
frame 9 . 
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Fl.206 DISEP (DISPLAY_EXCHANGE_PACKAGE) 


Purpose: The purpose of the DISPLAY_EXCHANGE_PACKAGE subcommand is 
to produce a formatted display the contents of a selected 
exchange packagee 


Format: Display _exchange_oackage 
exchange = integer or keyword value 
processor = integer 
title = string 
output = File reference 
status = status variable 


Parameters: exchange (e) 


The exchange paraneter designates the exchange package to 
be interpreted. An integer value is interpreted as the 
starting real memory addrass of an exchange package. 


The following keywords may also be used: 


Active (a) indicates that the contents of the CPU at 
the time of the dump are to be displayed, 


Monitor (m) indicates that the processor maintenance 
registers ars to be accessed and the value in the MPS 
register used as the real memory address of the 
exchange package, 


Job {j) indicates that the processor maintenance 
registers are to be accessed and the value in the JPS 


register usad as the real memory address of the 
exchange package. 


If you do not specify this oarameters the active exchange 
package is displayed, 


processor (p) 


The processor parameter specifies which processor is to be 
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Examples: 


selected for the subcommand in a multi-processor 
environmente The processor determines which set of 
maintenance registers are to be used for virtual addressing 
parameters page size mask» page table address and page size 
mask» In addition if job or monitor is specified for the 
exchange parameters the jos or mps register for that 
processor will be accessed. If active is specified for 
exchanges the processor oarameter determines which 
processor's active exchange package is to be used. 


Allowable values are 5 through 3. If you do not specify 
this parameter, a default value of 0 is used. 
Titie (+t) 


A string of i to 31 characters may be specified and is 
included in the page headers if these headers are generated. 


If you do not soecify this parameters» the string ‘display_ 
exchange_package' is used. 


GQutput (0) 

Indicates the file receiving the display. If you do not 
specify this paranetears the value specified on the ANALYZE 
DUMP_COMMAND output parameter is used. 

Status 


Optional status variable. 


ad/displtay_exchange_oackage e= job 
Exchange address = 5054A40(16) 


Exchange packaget PROCESS_COMMAND_IN_LIST + AO(16) in 
CLMSPROCESS COMMANDS 
monitor conditions: page tabie search without find 


9009 P B 10 5F450 
vmid/uvmid 00396 AQ B & 33990 


Fil-21 
SOFTWARE RELEASE BULLETIN 
85/03/29 
NOS/VE Riel.2 LEVEL 630 
NOS/VE Dump Analyzer 
F1.0 NOS/VE DUMP ANALYZER 
Eis 206 aes (DISPLAY, EXCHANGE. PASKAG a 


Fiags/te 0092 A B 
user mask F777 A? B 
monitor mask FFFC A3 B 
ucr 0099 A4 B 
mer 9940 A5 B 
kypt cl/ipid 0999 A6 8 5 18520 
kKypt mask 09690 A7 F FFF -809000000 
kypt code gooo A8 B ° 18526 
B 5 18520 
B 4E 20506 
B 4E 3A68 
B 4E 39F7 
B SE 2050 
B F 0 
B 4t 3F17 


pit | TFL AA 
base const 0090 AC 


ad flags 9000 AE 
stl 0954 AF 


XO 99099 0506 0000 0903 
Xi 00009 0090 9000 6000 
XZ 6990 0000 0000 90901 
X3 0999 9006 9000 0000 
X¥4 0999 9990 0000 0000 
X5 9990 9000 0000 G000 
X6 90999 BOGE 0000 2050 
K7 9090 9000 0000 0000 
X8 9909 0000 O0OG 6918 
X9 0909 9000 0000 0006 
XA 00090 00900 60006 0064 
XB 9009 0000 0000 076C 
XC 9099 0990 0000 0054 
X92 90900 0000 0000 OOFA 
XE 00909 00090 9000 0001 
XF 0990 0000 0000 0008 


md word 0000 00900 0000 0000 


sta DO5C utp 1 FFF 7FFFFFFF 
58890 trao 1 c.. 0 
dob ind/mask 0000 db tist F FFF -80000000 


max ring OOOF tos 
0009 tos 
0000 tos 
0000 tos 
0065 tos 


OOo WN he 
“ 
oooTc 
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9000 tos 4 9 0 0 
009090 tos 7 9 C 0 
0000 tos 8 9 0 0 
0000 tos 9 9 0 0 
0900 tos 19 9 0 0 
0909 tos 11 8 4E 3976 
00905 tos 12 90 0 6 
0900 tos 13 0 0 0 
0059. tos 14 9 0 0 
66009 tos 15 9 0 0 
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F127 DISNR (DISPLAY _MAINTENANCE_REG ISTERS) 


Purposes Disolays the contents of the processor maintenance 
| registers» iou maintenance registers or memory maintenance 
registers. 


Format? ~ DISPLAY MAINTENANCE REGISTERS or 
DISPLAY MAINTENANCE REGISTER 
element = fist of keavword value 
title = string a 
output = file reference 
status = status variable 


Parameters: element (elementss 2) 


Soecifies the elenents whose maintenance registers are to 
be displayed. Possible values are: 


Processor {(p) 

input_outputlunit (Ciou) 

memory {m) 

ali (a) 
If you do not specify an element for this parameters the 
registers from all elements are displayed. 


Title (t) Specifies a string of 1 to 31 characters which is inctuded 
in the page headers if these headers are generated. 


If you do not specify a tities the string "display_ 
maintenance_registers™ is used ; 


Output (o) Specifies the file receiving the display. If you do not 
specify an output Files the value specified on the ANALYZE_ 
DUMP_COMMAND output oarameter is used. 
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status 


Optional status variable. 


Examples: 


ad/display_maintenance_ registers 


090 


PROCESSOR 


0202 


0000 


9006 
G900 
0000 
o00c 
5000 
0090 
0000 


o006 


C0C0 
0000 
O000 
0000 
0000 
0000 
4000 


0800 


0000 
00900 


0000 


0202 


0000 


0060 
90900 


06900 % 


9000 


1003 | 
0000 | 


0600 


0000 ¢ 
6000 | 
0000 ¢ 
0600 | 
6000 ¢ 


0000 


OG00 §& 
OCO00 | 


0000 


0000 


0000 


0000 | 


0) 
0202 


C039 


9292 


HLO9 


0009 
0012 
6900 
O1F8 
D44C 
9999 
9290 
9094 
A2F3 
0909 
OD1F 
0078 


2 9780 


108) 
9909 


9909 


9099 
9900 


9999 


status summary 
bit 62 ! corrected error 
element id 
element: PROCESSOR 
model 3 855 
s/n ?: 91069 
processor id 
options installed 
vm capability list 
dependent env ctri 
program addr 
mtr process state ptr 
untranslatable pointer 
segment tabte tength 
segment table addr 
page table address 
page table length 
page size mask 
job process state ptr 
sys interval timer 
proc fault status 0 
bit 01 : correctable / 
soft / bypass error » 
MAC operation PDM 
proc fault status 1 
bit 04 3 A stream stage 2 
data register parity error 
proc fault status 2 
proc fault status 3 
proc fault status 4 
bit 41 : successful retry 
bit 47 ? rank 50 before 
PONR PDM 
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85 0006 9000 GO03 9995 proc fault status 5 
86 0000 GOOG 0003 9905 proc fault status 6 
87 Yo06 GOGG 86000 9990 proc fault status 7 
B88 YO00 0909 G000 0090 proc fault status 8 
89 8000 0060 0909 9999 proc fault status 9 
MEMOBRY 
0O 0000 0000 0005 90999 status summary 
10 «0090 06000 0131 9902 element id | 
element: MEMORY 
model $ 850 
s f/ n : 00062 
12 06808 G065 6009 209095 options installed 
20 0006 OG0C 3209 9099 environment control 
21 4000 0000 OFFS 9999 bounds register 
AQ 6006 6006 66090 00909 corr err tog 
AS 9000 00009 0000 90006 uncorr err log 1 
A8 0006 6000 0009 0009 uncorr err fog 2 
INPUT/OUTPUT UNIT 
00 1610 1616 1910 1919 status summary 
bit 59 2 summary status 
10 «69006 0000 0220 39633 element id 
element: [OU 
model 3 835 
s/n 3 0633 
12 G000 OFFF AFFF: OFOF options installed 
18 0006 0006 0009 9909 fault status mask 
21 0718 1F1F 09900 0199 os bounds 
30 «9000 0000 0009 900999 dependent env control 
49 0600 0006 6059 FFD) status reg 
8G GOOG 0000 9005 939090 fault status 1 
Bi 6996 6000 0009 99090 fault status 2 


AO 0000 8000 69909 9911 test mode 
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Purpose Displays central nemory in numeric or ascii formate. The 


address of the menory to be displayed can be specified as 
process virtual address (pva)» a system virtual address 
(sva) or as areal menory address (rma). 


Format? Display memory 
address = integer 
bytes s integer 
exchange = integer or kevword value 
processor = integer 
address _mode = keyword value 
display option = List of keyword value 
title = string 
radix = integer 
output = File reference 
status = status variable 


Parameters: Address (a) 
Specifies the address of the memory to be displayed. Its 
format depends on the value supplied For the ADDRESS MODE 
parameter. 
This parameter is required. 
Bytes (b) 
This parameter indicates the number of bytes to be 
displayed. If you do not specify a value for this 
parameters eight is used. 
Exchange {e) 
Designates the exchange package to be used to define the 
virtual address. An integer value is interpreted as the 


starting real memory address of an exchange package. 


The following keywords may also be used? 
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o Active (a) - indicates that the contents of the CPU at 
the time of the dump are to be used. 


o Monitor (m) - indicates that the processor naintenance 
registers are to be accessed and the value in the MPS 
register be used as the real memory address of the 
exchange package, 


0 Job (j) ~- indicates that the processor maintenance 
registers are to be accessed and the value in the JgPS 
register be used as the real memory address of the 
exchange package. . 


If you do not specify an exchange packages the active 
exchange package is used. 


processor ip) 


Specifies which processor is to be selected for the 
subcommand in a multi-processor environment. The processor 
determines which set of naintenance registers are to be 
used for virtual addressing parameters page size masks page 
table address and page size mask. In additions if * job or 
monitor is specified for the exchange parameters, the jes or 
mps register for that porocessor will be accessed. If 
active is specified for exchanges the processor parameter 
determines which orocessor's active exchange package is to 
be used. 


Allowable values are 3 through 3. If you do not specify a 
value for this parameters O is used. 


address_mode (am) 


Determines the interoretation of the address parameter. 
Possible settings are? 


o process_virtual_ address (pva) - causes interpretation as 
follows: 


sssannannnna( i145) 
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with s being the segment number and n the offset. 
o system virtual address (sva) - 
aaaannnannnnna(1s) 


a is the assigned segment identifier tCasid) and n is the 
offset. 


o real _memory_address (rma) - Address specifies the 
starting real nemory byte address to be displayed. 


If you do not specify a vatue for this parameters process, 
virtual_address is used. 


Display option (do) 

Allowable values: 

o numeric (nb —- displays the numeric representation of the 
requested memory. The interpretation of the memory 
depends on the radix parameter. 

o Ascii (a) - disolays the ascii characters represented. 

If you do not specify a value for this parameters numeric 

and ascii are displayed together. 

Title (t) 


Specifies a string of 1 to 31 characters which is included 
in the page headers if these headers are generated, 


If you do not specify a tities, the string ‘display memory? 
is used. 


Radix (r) 
Determines how the nuneric data will be interpreted and 


displayed. Any integer hetween 8 and 16 may be specified. 
If the radix is 15» each byte of memory is interpreted as 


. . F1l-29 
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= B5/03729 
NOS/VE R1.2e2 LEVEL 630 
NOS/VE Dump Analyzer 
F1.0 NOS/VE DUMP ANALYZER 
Fi.2.8 DISPLAY MEMORY (DISM) 


an 8 bit unsigned integer.» If the radix is 8» the byte 
count is rounded up to the nearest number of words (8 
bytes) and the address voaramneter is adjusted down to the 
nearest word boundary. Each word is then displayed as an 
unsigned integer. For all other radixes»y the bytes 
parameter is adjusted to display an integral number of 8 
byte entities. Each 8 bytes is displayed as a signed 64 
bit integer. 


If you do HOt specify a value for this parameters 16 is 
used. 


Output (o) 
File receiving the disolay. If you do not specify an 
output files, the value soeacified on the output parameter on 
the analyze_dump command is used. 
Status 
Optional status variable. 

Example: ad/display memory a=3999006090(16) 20(15) exj 


00000000 4142 4147 2454 5253 5F35 2020 2020 2020 ABAGSTRS_5 
00000010 2020 2020 2920 20929 2026 2920 2026 2020 
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Fl.229 DISPLAY_PP_LMEMORY (OISPM) 


Purpose? This subcommand displays the contents of peripheral 
processor memory. 


Format: DISPLAYUPP_UMEMORY 
ppinumber = integer 
address = integer 
words = integer 
disptay_option = list of keyword value 
radix = integer 
display _relocatior_ register = boolean 
titie = string 
output = file reference 
status = status variabla 


Parameters? ppinumber (pn) 
Specifies pp whose contents are to be displayed. Allowable 
values are integers from 9 to 25. An error status is 
returned if the po snecified is not present in the dump, 
This parameter is required. 


address (a) Specifies the starting address of op memory to 
be displayed. Values of 3 through 4095 are allowed. 


If you do not specify a value for this parameters a value 
of 0 isused,. 


words (w) 


This parameter specifies the number of words of pp memory 
to be displayed. Values of 0 through 4096 are allowed, 


If you do not specify a value for this ocarameters a value 
of 4096 is used. 


display option (do) 


Specifies either numeric (n) displays ascii (a) display or 
both. 
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If you do not specify a disolay option both numberic and 
ascii are disptayed, 


radix (r) 


Determines how pp menory Is displayed. If the radix is 
eights and the most significant 4 bits of a word are zeros 
the word will be disolayed with 4 octal digits. If these 
bits are non-zero» 6 octal digits will be used. With any 
radix» a word of all zeros will be displayed with hyphens 
(-). The radix used to disolay the memory will also be the 
radix used to disolay the address of the memory being 
disolayed. 


display _relocation_register (drr) 


Indicates whether or not to display the contents of the 
pp's relocation register along with the memory display. 

The parameter is typ2 boolean the default is to display the 
register if the entire contents of the the ppts memory is 
also being displayed. If only a portion of the opts memory 
is being displayed then the defauit is to not display the 
relocation register. 


Titte (t) 


Specifies a string of 1 to 31 characters which is included 
in the page headers if these headers are generated. 


If you do not specify a titles the string 'display_po_ 
memory pp _number='»s concatenated with the pp number being 
displayeds is used 

Dutput {o) 

File receiving the disnlay. If you do not spescify an 
output files the walue soecified on the output parameter on 
the analyze dump command is used, 


Status 
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Optional status variable. 


Exampies: 


R register = 


0000 
0010 
0020 
9030 
0040 
0050 
0060 
G070 


2463 


OO01 
0004 
0013 


6014 


0001 
0019 
9490 


es 


9091 


— eh ae a. 


A A Cl a 


ab ate A aD: 


0002 


ereren 
GO25 
C025 
0004 
0400 


0570 


ad/DISPLAY_PP_MEMORY po _number=6 address =0 
drr=yes do=n 
0(8) 


6445 
0035 
1730 


6446 


0001 


ae nie cen ae 


1440 


oh a aa 


A ie ae ae 


85/03/29 
words=100(8) 
0144 020466 ae 
0029 6602 0004 
6240 0240 0002 
0046 0001 ets ea 
0002 0004 -——— 


6010 


i ARR stile le 
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QUIT (qui) 
Purpose? Terminates the analyze dumo utility. 
Format? quit 
status = status variabla 
Parameters: Status 


Optional status variable, 
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Fle3 DUMP _ANALYZER_EUNCTIONS 


The following functions are provided: 
» S$MAINTENANCE_REGISTER ($2) 


+ SMEMORY (SMEM) 

« $MEMORY_STRING ($MS) 

+ SMODULE 

» SOFFSET (S$OFF) 

»  $PP_LMEMORY ($PM) 

+ $PROCESS_REGISTER (SPR) 
+ SREAL_MEMORY ($RM) 

»  $SREAL_MEMDRY_ADDRESS ($RMA) 
+ $RING 

» $SECTION ($SEC) 

« $SEGMENT ($S5E6) 


«© $SYMBOL_LADDRESS ($35A) 
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Fl.23e1 SMAINTENANCE_ REGISTER (3MR) 


Purpose? 


Formats: 


Parameters: 


Remarks? 


Examples 


Returns the contents of the specified maintenance 
register. The result is tyne integer. 


$MAINTENANCE_REGISTER (registers element» processor) 


register 


Specifies the register whose contents are to be returned as 
the function result. [t may be either a keyword or an 
integer. Allowable keywords are MONITOR PROCESS STATE 
(MPS) and JOBLPROCESS_STATE (JPS). Allowable integers are 
any valid register number, 


This parameters is required. 

element 

Specifes which set of naintenance registers are to be 
accessed. Allowable values are processor (p)» INPUT _DUTPUT_ 


UNIT (ious and nemory (mn). 


If you do not specify a value for this parameters processor 
is used. 


processor 


Specifies the number of the processor to be used for 
processor maintenance register access. 


If you do not specify a value for this parameters a value 
of O is used. 


An error status is returned if the register is not 
contained in the dumo. 


ad/disv $MAINTENANCE_25GLSTER(41(16)) 
269000(16) 
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Fle3e2 SMEMORY ($MEM) 


Purpose; Returns the contents of central memory. The result is type 
integer. 
Format: SMEMORY(address» byte _caunts exchanges processor, address_ 
mode) 
Parameters: address 


Specifies the address whose location is to be returned as 
the result of the function. 


This parameters is raquired,. 

byte_count 

Specifies the number of consecutive bytes which constitues 
the value returned oy tmemory. The minimum is one byte and 


maximum is eight. 


If you do not specify a value for this parameters a value 
of six is used. 


exchange 


Designates the exchange package to be used to define a 
process virtual address» It may be specified as an integer 
or as a keyword. An integer value is interpreted as the 
starting real memory address of an exchange package. 


The following are allowable keywords: 


o Active (a) - indicates that the contents of the CPU at 
the time of the dump are to be used. 


o Monitor (m) — indicates that the processor maintenance 
registers are to he accessed and the vatue in the MPS 
fegister be used as the real memory address of the 
exchange package. 


o Job (j) - indicates that the processor maintenance 
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Examples 


registers are to be accessed and the value in the JPS 
register be used as the real memory address of the 
exchange packages. 


If you do not soecify a vatue for this parameter, the 
active exchange package is used, 


processor 

Specifies the number of the processor to be used for 
maintenance register accesss to obtain an exchange package 
address or to locate an active exchange package. 


address_mode 


This parameter determines the interpretation of the address 
argument. Possible settings are? 


o PROCESS_VIRTUAL_ADDRESS (PVA) - causes interpretation as 
follows: 


sssnnnnnnnnati4) 
with s being the segment number and n the offset. 
o SYSTEM_LVIKTUAL_LADDRESS (SVA) - 
aagaannnannnnna(l14) 


a is the assigned segnent identifier (asid) and n is the 
offset. 


0 REAL_MEMORY_ADDRESS {RMA) = Adress specifies the 
starting real memory byte address to be displayed. 


If you do not specify a vatue for this parameters process. 
virtual_laddress is useds 


ad/disv tmemory(8,s 82 nm» 93» pva) 
400320006400 7CFO(16) 
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F1.323 SMEMDRY_STRING (MS) 
Purpose? Returns the contents of central memory. The result is type 


string. 


Format SMEMORY_ STRING Caddress»s byte _counts exchanges processor» 
address mode) 


Parameters: address 


Specifies the starting address of centrai memory to be 
returned as the resutt of the function. 


This parameter is required. 
byte count 


Specifies the number of consecutive bytes which constitues 
the value returned by SMEMORY_ STRING. The minimum is zero 
bytes and maximum is 255. 


If you do not specify the value of this parameters a value 
of one is used. 


exchange 


Designates the exchange vackage to he used to define a 
process virtual address. It may be specified as an integer 
or aS a keyword. An integer value is interpreted as the 
starting real memory address of an exchange package. 


The following are allowable keywords: 


o Active (a) - indicates that the contents of the CPU at 
the time of the dumo are to be used. 


o Monitor (m) - indicates that the processor maintenance 
registers are to he accessed and the value in the MPS 
register used as the real memory address of the exchange 
package. 
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0 Job (j) - indicates that the processor maintenance 

registers are to be accessed and the value in the JPS. 
register used as the real memory address of the exchange 
package. 


If you do not specify a value for this parameters the 
active exchange package is used, 


processor 
Specifies the number of the processor to be used for 
maintenance register accesses to obtain an exchange package 
address or to locate an active exchange package. 


address mode 


Determines the Interpretation of the address argument. 
Possible settings are? 


o PROCESS_VIRTUAL_LADDRESS (PVA) - causes interpretation as 
follows: 


sssnnannnannnii§) 
with s being the segment number and n the offset. 
Oo SYSTEMLVIRTUAL ADDRESS (SVA) - 
aaaannnnnnnnal(l16) 


ais the assigned seqment identifier (asid) and n is the 
offset. 


oO REALUMEMDRY_ADDRESS (RMA) - Adress specifies the 
starting real memory byte address to be disolayed. 


If you do not specify a value for this parameters process, 
virtualladdress is used, 


ad/scb = S$SYMBOL_LADDRESS(mtyv$scb) 
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ad/msga = secb + 3af14) 

ad/msgl = Smemory(s¢cb+38(16) 1 monitor) 
ad/disvy MEMORY USTRING(msga msgi monitor) 
HR—- unable to flush file 
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Fl.2324% S$MODULE 
Purposes Returns the module name corresponding to a given address by 
searching the debug table. The result is type string. 


Format? $4ODULE( address) 


Parameters: address 


Specifies the process virtual address to be used to search 
the debug table. An error status will he returned if no 
module can be found that corresponds to the given address. 


Example: ad/disv $modul e(391¢0093e17e(16)) 
BAMSSYS_BLK_VARTABLE_REC_FAP 


SOFTWARE RELEASE BULLETIN 


F142 


85/03/29 


NOS/VE R1ie1.2 LEVEL 630 
NOS/VE Dump analyzer 


nts ees ane SE OR RO a ee sae oe 


F1.60 NOS/VE DUMP ANALYZER 
F1.3.5 $NIL_PVA (SNP) 


Fle325 SNILLPVA (SNP) 


Purpose? 


Format: 


Parameters: 


Example: 


Returns a value of true or Palise based upon the given 
address» A nil opwa is an integer of the form: 


rsssnnannnnnvantid) 
Where r = OF (16)9 sss = OF FFLI16) and the offset portion is 
negative (bit 2 ** 31 is set). The result is type boolean, 


SNILUPVAladdress) 


address 


Specifies the process virtual address to be tested. 


ad/disv NIL _PVAC$ menor y(300000000(16))) 
FALSE 

ad/disv SNIL_PVACOFFFFFFFFFFFFI16)) 

TRUE 

ad/disv S$NIL_PVA() FFFFADN00N90(16)) 

TRUE 
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F1le3-5 SOFFSET (S0FF) 
Purpose? Returns the segment offset portion of a given address. The 
result is type integer. 


Format: $OFFSETC address) 


Parameters: address 
Specifies the address that is to be interpreted. 
This argument is required, 


Examp|a3 ad/disy $O0FFSET(301¢9093e172(16)) 
3E17E(16) 
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Fie3.7 SPP_MEMDRY ($PM) 


Purposes: 


Format: 


Parameters: 


Example; 


Returns the contents of a word of pp memorye 


type integer. 


$PP_MEMORY{pp_numbers address) 


pp _ numbder 

Specifies the numder of the oerpheral processor. 
60 to 25 are allowed. Uf the specified op is not 
in the dumps an error status is returned. 

This parameter is required. 

address 


Specifies the word in op menory to be returned. 
G to 4695 are allowed. 


This parameter is required, 


ad/disv $PP_ MEMORY (69140(8)) 
6(8) 
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F1l.308 SPROCESS_REGISTER ($PR) 


Purpose? 


Format? 


Parameters: 


Returns the contents of a process register as defined by an 
exchange package. Tha exchange package can be one active 
at the time of th2 dumo or it can be an exchange package in 
memorye The result is tyoe integer. 


S$PROCESS_REGISTER( register _ kinds register numbers exchanges 
processor) 
register kind 


specifies the kind of register. The following keywords are 
allowed: 


9 p 
Q a 
0 x 


o monitor_conditiona_register (mcr) 
o user condition register (Cucr) 
o segment _table_address (sta) 


o top_of_ stack (tos) 


This argument is required. 

register_number. 

Defines the a» x or top_of_stack register. It is ignored 
for other register_kinds. Allowable values are 6 through 
15 for a and x» 1 through 15 for top_of_ stack. 


If you do not specify a value for this parameters a value 
of 0 is used. 


exchange 
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F1.3-8 SPROCESS_REGISTER (SPR) 


Specifies the exchange oackage location. It may be given 
as an integer or as a keyword. An integer value is 
interpreted as tne starting real memory address of an 
exchange package@e 


The following are allowable keywords? 


o Active (a) ~— indicates that the contents of the CPU at 
the time of tne dumvo are to be used. 


o Monitor (mm) =- indicates that the processor naintenance 
registers are to be accessed and the value in the MPS 
register be used as the real memory address of the 
exchange package, 


o Job (j) - indicates that the processor maintenance 
registers are to be accessed and the value in the JPS 
register used as the real: memory address of the exchange 
packageé.s : 


If you do not specify a value for this parameter, the 
active exchange package is used. 

processor 

Specifies the number of the processor to be used for 


maintenance register accesss to obtain an exchange package 
address or to focate an active exchange package, 


Examplet ad/disv $PROCESS_REGISTERLa 2) 
LOOFOO000CB0(16) 
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F1l.3.9 SREALLMEMORY_ ADDRESS ($RMA) 
Purpose: Translates a process virtual address or a system virtual 


address into a real memory address. It can also be used to 
test for a valid real memory address. The result is type 


integer. 

Format: SREAL_MEMORY_ADDRESSCaddress»s exchanges processors address_ 
mode) 

Parameters: address 


Specifies the address to be converted. 
exchange 


Designates the exchange voackage to be used to define the 
virtual address. It may be specified as an integer or as a 
keyword. An integer value is interpreted as the starting 
real memory address of an exchange package. 


The following are allowable keywords: 


o Active (a) - indicates that the contents of the CPU at 
the time of the dumo are to be used, 


o Monitor (m) - indicates that the processor maintenance 
registers are to be accessed and the value in the MPS 
register be used as the real memory address of the 
exchange package. ; 


o Job (j) - indicates that the processor maintenance 
registers are to be accessed and the value in the JPS 
register be used as the real memory address of the 
exchange package, 


If you do not specify a value for this parameters the 
active exchange package is used. 


processor 
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AEP UTNE URNS AND ANS ney ON eR OR SY 


Example: 


A AL AON NE ROARS <TD A EO SA A A AS NS NT AER A AD ND A NE: A ED ON A SO A AO OO OE AD A ENED RED EN END AUD ATAU ET AEN ANTS EET NN RN A ED A ST TD A EN A a 


Specifies the number of the orocessor to be used for 
maintenance register access» to obtain an exchange package 
address or to locate an active exchange package. 


address mode 


treal_memory_address ($rma) 


This argument determines the interpretation of the address 
parameter. Possible settings are: 


0 PROCESS_VIRTUAL_ADDRESS (ova) - causes interpretation as 
follows: 


sssnannnannnn (16) 
with s being the segment number and n the offset. 
o SYSTEM_VIRTUAL_ADDRESS (sva) - 
aaaannnnnnnn(i6) 


a is the assigned segment identifier (asid) and nis the 
offset. 


0 REAL_LMEMDRY_ADDRESS i{rna)d - Adress specifies a real 
memory addresses An @rror status will be returned if the 
given address is not on the dump. Otherwises the 
address argument is returned as the function result. 


If you do not specify a value for this parameters PROCESS_ 
VIRTUAL_LADDRESS is used. 


ad/disy $RMA(190F90000089(15)) 
588CB0(16) 
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FisO NOS/VE DUMP ANALYZER 
Fle3e10 $RING 


F1l.23210 $RING 
- Purpose? Returns the ring portion of a given process virtual 
address. The rasult is type integer. 


Formats SRINGl address) 


Parameters? address 
Specifies the address that is te be interpreted. 
This argument is required, 


Example? ad/disy $RING(301¢0093e172{(16)) 
3(16) 
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Fl.3.11 SSECTION (85SEC) 
Purposes Returns the section name and offset into the section given 


a process virtual address. This function uses the debug 
table. The result is tyoe string. 


Formats: S$SECTION( address) 


Parameters: address 


Specifies the process virtual address to be used to search 
the debug table. An error status will be returned if no 
entry can be found that corresponds to the given address. 
This parameter is required, 


Examples ad/disy SSECTION(361c0003e17e(16)) 
GETNEXT + 9AE(15) 
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File3e-12 $SEGMENT ($5E6) 


Purpose Returns the segment portion of a given process virtual 
address. The result is type integer. 


Format? S$SEGMENTCaddress) 


Parameters? address 
Specifies the address that is to be interpreted. . 
This argument is required. 


Example’ ad/disv $5 EGMENT(3°1¢c0093e17e(16)) 
| 10 (16) 
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Fil.3.13 SSYMBOL_LADDRESS {$5A) 


Purpose: 


Format? 


Parameters? 


Examples: 


Converts a name into a orocess virtual address by accessing 
the debug table. [t allows you to find the address of a 
variables procedure or module. The resuit is type integer. 


SSYMBOL_LADDRESS(symbol_name) 


symbol oname 
Specifies the name of the variables procedure of module. 
This argument is required. 


ad/disv SSYMBOL_ADDRESS(mtvSscb) 
100900238(16) 
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Fie4 QUICK REFERENCE 
Fle4sl ANALYZE_DUMP COMMAND 


analyze dump {anad) 


dump_files df 2 file = Soptional 

restart _files rf: file = Stocal.restart_ file 

debug _ tables dt 3: file or key running_systems rs» nones n = running _systen 
tities ¢ $ string 1.2225 = toptional 

outputs o : file = Soutout 

status ’ var of status = tootional 


Fle4e2 SUBCOMMANDS 


change_default (chad) 
exchanges e : integer 0..3max_inteaer or key monitors ne jobs js oe» 
actives a = toptional 
processors p integer 0.2.3 = toptional 
bytes» b integer 042233554432 = tSoptional 
address mode» am: key process virtual address» Pvap eo 
system_virtual address» svas real_menory_addresss .. 
rma = toptional 
wordss w : Integer © .2. 49946 = toptionai 
status ; var of status * toptional 


ae &e 


change_processor_register (change_processor_registers» chapr) 
job process _ states Jjps 2 integer O..$max_integer 2 toptional 
monitor process states mps : irvteger Oe.e$max_integer = toptional 
page_size mask», psm 3 integer 922-127 = S$ontional 
page_table_address» pta 2? integer 9.e$max_integer = toptional 
page_tabie_lengths oti t integer 0.42255 = goptional 
processors p : integer 9.2.3 or key alls» a = 0 
status : var of status = S$optiona! 


copy_memory (copm) 
address» a 
files f 
byte _counts bc 
exchanges e 


integer = treauired 

file = treaquired 

integer Oeebmax_inteoer = 190000(16) 

integer D..%max_integer or key actives as o>. 
monitors mm» jobs j = active 

processors p $ integer 9.3 = 9 
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Fl. paces SUee anne’? 
address _modey am 3 key process _virtual_addresss pvas a+ 


status 


system_virtual_address» svas oe» 
real _nemory_address»s tfma = oe 
process virtual _waddress 

> var of status 2 Soptional 


copy pp_memory (coppm) 


pp_numbers on 
files Ff 
address» a 
word counts we 
status 


: integer 6..25 = tragquired 
file = ¢reaquired 
integer 0224995 = 9 
integer 0224996 = 4096 
var of status = tootional 


~~ 6 et UBS 


display call (display calls» disc) 


exchanges e@ 


processors 0 
counts c 
starts s 


dispiay_loptions 
titles, ¢t 
outputs o 
status 


: integer 0..3nax_integer ofr key monitors m» jobs js» as 


actives a = active 
: integer 6..3 2 9 
t+ Integer 1.2.210999 or key all = all 
$ integer 0..19900 or key exchange_packages, ep .. 
= exchange_package 
do t fist 1.2.2 of key Full» f» briefs b» saves s = brief 
3 string 1..31 = 'disotay call! 
3 file = Soutout 
s var of status = topotional 


display exchange _package (disep) 


exchanges e H 


processors p 3 
titles t 3 
outputs o 3 
status 3 


integer G..tmax_integer or key monitors ms jobs js »o» 
actives a= active 
integer 0..3 * 9 


string 1.2231 = 'dispolay_exchange_package'! 


file = $output 
var of status = toptional 


display maintenance_registers (disolay_maintenance_registers dismr) 


elements e 


processors p 
disolay options 
titles, ¢t 
outouts o 


: key processors vo» input _output_units ious memorys ms 
aliio= all 

? integer 0..3 = 9 

2 key Fulls fs briefs b = fuil 

? string 1..31 = 'disolay_maintenance_registers! 

2 file = Soutput 


do 


. | Fi-55 
SOFTWARE RELEASE BULLETIN 
85/03/29 
NOS/VE Rieie2 LEVEL 630 
NOS/VE Dump Analyzer 


Fi.O NOS/VE DUMP ANALYZER 


status ’ var of status = Sopntional 


display memory (dism) 
address»s a 2 integer * $Srequired 
bytess b integer 3..335354432 = 28 
exchanges e integer 0..tnax_integer or key actives as eo» 
monitors mses jobs j = active 
processors p 2 integer 02.3 = 9 
address modes am 3 key process _virtualladdress» pvas ee 
systen_virtualt_address» Svas ose 
real _nemory_addresss rma ™ ee 
process _virtualvladdress 
displayloptions do * list Llee2 of key numerics ns asciis a o>» 


ee 686 


= (nuneric» ascii) 

titles, ¢t string 1.231 2 'display_ memory? 

cutouts o : file = Sontional 

status 3 var of status = foo0tlional 
display _pp_memory (dispm) 

Pelnumbers on 2 integer 0..25 = tSrequired 
addresss a : integer 6.224095 = 9 

words» w : integer 6.224096 = 4096 
display_options do s fist 1.4.2 of key numerics nse oe 


ascitis a = (numerics ascii) 


radix,ys r 2 integer 8.2.15 = 8&8 

display relocation registers drr ? hoolean = $optional 
titles ¢t : string 12.31 = tHoptional 
outputs o 3 flie = toptional 

status ’ var of status = toptional 


quit (qui) 
status 3 var of status = tStoptional 


F1l.4.3 FUNCTIONS 


$maintenance register: integer ($nr) 

register ?: integer OQ .. OF fF115) or key mnonitor_process_ states mps» 
job_process states jos = $required 

element t key processors ps input _output_units ious, memorys n 
= processor 
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processor : integer 0..3 = @ 


memory: integer ($mem) 
address 2 integer = 


Fi-56 


85703729 


$required 


byte_count Integer 1.4.3 * 6 
exchange 3 integer Oe»dmax_ integer or key actives ay monitors ms 


jobs 
processor 
address modes am 


es 8668 


j = active 
integer 0..3 = 9 
key process _virtual_address»s pvap oe 


system_virtual_address» sva» reai_memory_address» 


rma = 


memory strings string {($ms) 


process_virtual_address 


address : integer = Srequired 
byte_count 3 integer 6..,osctmax string _size = 1 
exchange . integer O..3Smax. _integer or nee actives as monitors my» 


jobs j= active 


processor 
address _modes am 


se be 


integer 6..3 = 9 
key process _virtual_address»s pvas e+ 


System_virtual address» svas real_memory_addressy» 


rma = 


$¢modufe: string 
address: integer = trequired 


$nil_evat boolean (tnp) 
address: integer = trequired 


Goffseti integer (tof f) 
address? integer = trequired 


$pp_memory? integer ($¢pm) 
pp_number: integer 0 «2 25 * 
address 3: integer 0 «2 4095 


process_virtual_address 


$required 
= tregquired 


2 


2 
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$process_register: integer (tpr) 
register_type ’ key p»s as xs monitor _condition_registers mcr 
user _condition_registers ucr 
segment. ‘tablie-. _addressys stays eePe of stacks tos 
= $required 
register _number 3 integer 0..0f(15) = 0 


exchange * integer Oss$naxlinteger or key actives a» monitors ms 
jobs j = active 
processor 2 integer 0.3 = 9 


$real memory address! integer (rma) 


address 2 integer = $required 

exchange ? integer C..Smaxlinteger or key actives a» monitors ms e+ 
jobs j = active 

processor s integer G..3 = 9) 


address mode 3 key process _virtual_address» pvaps oe» 


systen_virtual_address» Svas real _memory_ address» 


rma = process _virtual_address 


ring: integer 
address : integer = $reaquired 


$section: string (%sec) 
address !: integer * $required 


$segment? integer ($seg) 
address : integer = $required 


$symbol address: integer ({(%sa) 
Symbol_name %? name = trequired 


eon 
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